Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Changed documentation files according some conventions #371

Merged
merged 33 commits into from
Jun 21, 2016

Conversation

steffengraber
Copy link
Contributor

Changed the documentation files according these conventions:

- [Frequently Asked Questions](frequently-asked-questions.md "Frequently Asked Questions")
- [Analog recording with multimeter](analog-recording-with-multimeter.md "Analog recording with multimeter")
- [Connection Management](connection-management.md "Connection Management")
- [Topological Connections](http://www.nest-simulator.org/wp-content/uploads/2015/04/Topology_UserManual.pdf "Topological Connections")
Copy link
Contributor

@jougs jougs May 30, 2016

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@heplesser: shouldn't we convert the topology manual to an IPython notebook or a plain markdown document at one point? I think the days of PDFs for documentation are over ;-) Can you please note this somewhere?

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@jougs Good idea! I created #374 to remind me about it.

@jougs
Copy link
Contributor

jougs commented May 30, 2016

Many thanks for this. Can you please check why it does not apply cleanly and look at my comments?

@jougs
Copy link
Contributor

jougs commented May 30, 2016

One more thing: can you please add a README.md to the md directory that explains the conventions and what the directory contains? Thanks!


After NEST is installed and configured properly, you can start to build your
model.

### Examples

A good starting point to learn more about modeling in NEST are the
[example networks](more-example-networks.md "Example networks")
that come together with NEST.
example networks that come together with NEST.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Why is this link gone now?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Sorry it is NOT working right now.


A minimal example for the exchange of spikes between two independent instances
of NEST is given in the example `examples/nest/music/minimalmusicsetup.music`.
It uses one [SLI script](../an_introduction_to_sli/index.html "An Introduction
It uses one [SLI script](an-introduction-to-sli.md "An Introduction
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This one still has a title.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Sorry, could not be found by my regular expression, because there was a linebreak.

@heplesser
Copy link
Contributor

@steffengraber Could you pull the newest changes from master, so that Travis can properly check the one modified code file?

@steffengraber
Copy link
Contributor Author

@heplesser
Done.

@@ -192,7 +184,7 @@ the help pages. The browser is set as an option of `helpdesk`. Please see the
file `~/.nestrc` for an example setting `firefox` as browser. Please note that
the command `helpdesk` does not work if you have compiled NEST with MPI support,
but you have to enter the address of the helpdesk
(`file://$PREFIX/share/doc/nest/index.html`) manually into the browser.
(`file://$PREFIX/share/doc/nest.md`) manually into the browser.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think this should stay. The browser won't understand markdown.

Copy link
Contributor Author

@steffengraber steffengraber Jun 21, 2016

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Ah, ok, you're absolutely correct.

@jougs
Copy link
Contributor

jougs commented Jun 20, 2016

👍 once my comments are addressed. Many thanks for the nice work!

@steffengraber
Copy link
Contributor Author

Done.

@jougs
Copy link
Contributor

jougs commented Jun 21, 2016

Very nice. I'm merging without second review, as these changes concern only documentation. Many thanks for this contribution!

@jougs jougs merged commit becdfc2 into nest:master Jun 21, 2016
@steffengraber steffengraber deleted the doc-filename-convention branch November 29, 2016 07:03
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants