Repository: ipython/ipython

Issue:
Notebook docs touchup
Cleaning up outstanding issues in notebook.rst.



Discussion:
Maybe one small comment. Otherwise looks great.

Did you fixed the backticks ? you can make some live experiments [here](http://rst.ninjs.org/?n=9762a58691da2557322279d85759362b&theme=nature) if needed.

Got it, thanks!

On Mon, Aug 5, 2013 at 7:38 AM, Matthias Bussonnier <
notifications@github.com> wrote:

> Did you fixed the backticks ? you can make some live experiments herehttp://rst.ninjs.org/?n=9762a58691da2557322279d85759362b&theme=natureif needed.
> 
> —
> Reply to this email directly or view it on GitHubhttps://github.com/ipython/ipython/pull/3902#issuecomment-22103308
> .

## 

Dr. David P. Sanders

Profesor Titular "A" / Associate Professor
Departamento de Física, Facultad de Ciencias
Universidad Nacional Autónoma de México (UNAM)

dpsanders@gmail.com
http://sistemas.fciencias.unam.mx/~dsanders

Cubículo / office: #414, 4o. piso del Depto. de Física

Tel.: +52 55 5622 4965

I just moved the "roundtrip" warning to the end, in the section on importing .py.

All comments now addressed; ready to merge.

This looks  good @dpsanders !  Thanks for all the help :+1: 

Do you want to add a warning that running over http/without password is dangerous even on localhost if machine has multiple user accounts ?

I fear that this is hardly a "touch up" of the docs anymore. @dpsanders can you squash these commits? it's getting quite a bit unruly. Please do not inlcude the non-functional changes (e.g. keep the htmlnotebook anchor as it was, or the link name change in `working_remotely.rst`)

Sure, please suggest the text to add and where to add it!

On Tue, Aug 6, 2013 at 2:12 AM, Matthias Bussonnier <
notifications@github.com> wrote:

> Do you want to add a warning that running over http/without password is
> dangerous even on localhost if machine has multiple user accounts ?
> 
> —
> Reply to this email directly or view it on GitHubhttps://github.com/ipython/ipython/pull/3902#issuecomment-22162226
> .

## 

Dr. David P. Sanders

Profesor Titular "A" / Associate Professor
Departamento de Física, Facultad de Ciencias
Universidad Nacional Autónoma de México (UNAM)

dpsanders@gmail.com
http://sistemas.fciencias.unam.mx/~dsanders

Cubículo / office: #414, 4o. piso del Depto. de Física

Tel.: +52 55 5622 4965

@ivanov OK, I see what you mean. How do I "squash these commits"?
(Though the link change in `working_remotely.rst` is the definition of "touchup" in my book!)

in the security section, change `you can` by `you should`. And something along "even if you use the IPython Notebook on a local machine, launching it without authentification can allow any other user or program of this machine to connect to IPython and run arbitrary command on your behalf. This is why we strongly advise to use password protected notebook over https"

As for squashing you should read [that](https://help.github.com/articles/interactive-rebase)


Resolving patch:
diff --git a/docs/source/conf.py b/docs/source/conf.py
--- a/docs/source/conf.py
+++ b/docs/source/conf.py
@@ -157,7 +157,9 @@
 
 # Additional templates that should be rendered to pages, maps page names to
 # template names.
-#html_additional_pages = {}
+html_additional_pages = {
+                         'interactive/htmlnotebook': 'htmlnotebook.html',
+}
 
 # If false, no module index is generated.
 #html_use_modindex = True


Test patch: