diff --git a/.gitattributes b/.gitattributes
new file mode 100644
index 0000000..3adb272
--- /dev/null
+++ b/.gitattributes
@@ -0,0 +1,9 @@
+# set default to auto
+* text=auto
+
+# some of our templates generate linux files, so need LF endings when checked out on windows
+*.ini text eol=lf
+*.py text eol=lf
+*.sh text eol=lf
+*.tpl text eol=lf
+*.yaml text eol=lf
\ No newline at end of file
diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..00eb297
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,40 @@
+## JetBrains
+.idea/
+*.iml
+*.ipr
+*.iws
+
+## VSCode
+.vscode/*
+!.vscode/settings.json
+!.vscode/tasks.json
+!.vscode/launch.json
+!.vscode/extensions.json
+*.code-workspace
+.history/
+
+## Vim
+[._]*.s[a-v][a-z]
+[._]*.sw[a-p]
+[._]s[a-rt-v][a-z]
+[._]ss[a-gi-z]
+[._]sw[a-p]
+Session.vim
+Sessionx.vim
+.netrwhist
+*~
+[._]*.un~
+
+## Emacs
+*~
+\#*\#
+/.emacs.desktop
+/.emacs.desktop.lock
+*.elc
+.\#*
+
+## macOS
+.DS_Store
+.AppleDouble
+.LSOverride
+._*
\ No newline at end of file
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..5f11fa0
--- /dev/null
+++ b/README.md
@@ -0,0 +1,38 @@
+# Kubeflow Notebooks
+
+[Kubeflow Notebooks](https://www.kubeflow.org/docs/components/notebooks/overview/) lets you run web-based development environments on your Kubernetes cluster by running them inside Pods.
+
+## What is Kubeflow Notebooks?
+
+Key features of Kubeflow Notebooks:
+
+- Native support for [JupyterLab](https://github.com/jupyterlab/jupyterlab), [RStudio](https://github.com/rstudio/rstudio), and [Visual Studio Code (code-server)](https://github.com/coder/code-server).
+- Users can [create notebook containers](https://www.kubeflow.org/docs/components/notebooks/quickstart-guide/) directly in the cluster, rather than locally on their workstations.
+- Admins can provide [standard notebook images](https://www.kubeflow.org/docs/components/notebooks/container-images/) for their organization with required packages pre-installed.
+- Access control is managed by [Kubeflow’s RBAC](https://www.kubeflow.org/docs/components/central-dash/profiles/), enabling easier notebook sharing across the organization.
+
+## Installation
+
+Currently, Kubeflow Notebooks must be deployed as part of a full Kubeflow platform (not as a standalone component).
+
+Please refer to the [Installing Kubeflow](https://www.kubeflow.org/docs/started/installing-kubeflow/) page for more information.
+
+## Documentation
+
+The official documentation for Kubeflow Notebooks can be found [here](https://www.kubeflow.org/docs/components/notebooks/).
+
+## Community
+
+Kubeflow Notebooks is part of the Kubeflow project, refer to the [Kubeflow Community](https://www.kubeflow.org/docs/about/community/) page for more information.
+
+Connect with _other users_ and the [Notebooks Working Group](https://github.com/kubeflow/community/tree/master/wg-notebooks) in the following places:
+
+- [Kubeflow Slack](https://www.kubeflow.org/docs/about/community/#kubeflow-slack) - Join the [`#kubeflow-notebooks`](https://kubeflow.slack.com/archives/CESP7FCQ7) channel.
+- [Kubeflow Mailing List](https://groups.google.com/g/kubeflow-discuss)
+
+## Contributing
+
+We are in the process of moving the Kubeflow Notebooks codebase from [`kubeflow/kubeflow`](https://github.com/kubeflow/kubeflow) to this repository ([`kubeflow/notebooks`](https://github.com/kubeflow/notebooks)).
+For now, please continue to make contributions by raising PRs on `kubeflow/kubeflow`.
+
+Please see the [Contributing to Kubeflow](https://www.kubeflow.org/docs/about/contributing/) page for more information.