title: Where should I place my settings and profiles for use with IPython/Jupyter 4.0?
body: <p>I've recently updated IPython (to 4.0) and have started using Notebooks after a period of some time not using them (since before <a href="http://blog.jupyter.org/2015/04/15/the-big-split/" rel="noreferrer">The Big Split</a>, I think), and have discovered that some of my settings need to be modified and moved from <code>~/.ipython/</code> to <code>~/.jupyter/</code>.</p>
  
  <p>For example, it appears that the <code>NotebookManager.notebook_dir</code> in </p>
  
  <pre><code>~/.ipython/profile_default/ipython_notebook_config.py
  </code></pre>
  
  <p>is ignored and has had its functionality <a href="https://stackoverflow.com/a/28839153/656912">replaced by</a> <code>FileContentsManager.root_dir</code> <a href="https://stackoverflow.com/a/31982416/656912">in</a></p>
  
  <pre><code>~/.jupyter/jupyter_notebook_config.py
  </code></pre>
  
  <p>Beyond isolated incidents like this, however, it's not clear to me how the configuration settings and profiles now work. In particular what files should be located where, and what they should contain. If, for example, I generate a new profile with</p>
  
  <pre><code>ipython profile create foo
  </code></pre>
  
  <p>I now get different files than I used to (and than those present in my existing profiles): where I used to get</p>
  
  <pre><code>ipython_config
  ipython_notebook_config.py
  ipython_nbconvert_config.py
  </code></pre>
  
  <p>I now get</p>
  
  <pre><code>ipython_config.py
  ipython_kernel_config.py
  </code></pre>
  
  <p>and as near as I can tell, none of my <code>ipython_notebook_config.py</code> are used.</p>
  
  <p>This (and the limited documentation) all leaves me a bit confused about where should I place my settings and profiles for use with IPython/Jupyter 4.0, specifically:</p>
  
  <ol>
  <li>Where should I place general notebook-related settings for use by all kernels/profiles? (I see that some go in <code>~/.jupyter/jupyter_notebook_config.py</code>, but it's not clear to me whether these would override settings loaded from elsewhere.)</li>
  <li>Where should I place profile-specific settings for use with notebooks? (Can I continue to use <code>ipython_notebook_config.py</code> files in <code>~/.ipython/profile_someprofile/</code> directories?)</li>
  <li>Where should I place kernel-specific settings for use by all profiles and applications. (For example, where should settings used by IPython for all profiles in both the shell and notebooks go?)</li>
  <li>How should I modify or update existing IPython profiles for use with 4.0.0? (For example, should all have a <code>ipython_kernel_config.py</code> file; should I delete the <code>ipython_notebook_config.py</code> and <code>ipython_nbconvert_config.py</code> files?)</li>
  </ol>
  
  <hr>
  
  <p>OS X 10.10.4; Xcode 6.4; CLT: 6.4.0.0.1; Clang: 6.1; Python Python 2.7.10 (Homebrew); Jupyter 4.0.4; IPython 4.0.0.</p>