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

Update documentation #24

Open
wants to merge 10 commits into
base: master
Choose a base branch
from
Open

Update documentation #24

wants to merge 10 commits into from

Conversation

clinssen
Copy link
Contributor

@clinssen clinssen commented Dec 7, 2023

  • make the GitHub landing page readme more minimal; point to ReadTheDocs for full documentation
  • merge "synapses in NEST" and "writing custom synapse models" pages
  • remove abstruse build.sh script in favour of better installation instructions on RtD and contents moved to GitHub workflow file
  • many small fixes in the documentation to make it consistent with current state of affairs

@clinssen clinssen added the documentation Improvements or additions to documentation label Dec 7, 2023
doc/neuron_models.rst Outdated Show resolved Hide resolved
doc/overview.rst Outdated Show resolved Hide resolved
doc/synapse_models.rst Outdated Show resolved Hide resolved
doc/extension_modules.rst Outdated Show resolved Hide resolved
doc/synapse_models.rst Outdated Show resolved Hide resolved
doc/synapse_models.rst Outdated Show resolved Hide resolved
doc/synapse_models.rst Outdated Show resolved Hide resolved
doc/overview.rst Outdated Show resolved Hide resolved
doc/overview.rst Outdated
.. attention::

Please note that the code in this repository is compatible with the latest
NEST version only; in particular the git "master" branch on

Choose a reason for hiding this comment

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

Is this accurate? Is the extension module really up-to-date to master and will always be?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

That is, at least, the theory :)

Copy link
Contributor

Choose a reason for hiding this comment

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

This statement is already mentioned in extension_modules.rst. Is this required here again?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

I would like to keep this as a highlight in README.rst as it's quite important to note.

doc/synapse_models.rst Outdated Show resolved Hide resolved
doc/extension_modules.rst Outdated Show resolved Hide resolved
doc/extension_modules.rst Outdated Show resolved Hide resolved
doc/extension_modules.rst Outdated Show resolved Hide resolved
doc/extension_modules.rst Show resolved Hide resolved
doc/neuron_models.rst Outdated Show resolved Hide resolved
doc/overview.rst Outdated
.. attention::

Please note that the code in this repository is compatible with the latest
NEST version only; in particular the git "master" branch on
Copy link
Contributor

Choose a reason for hiding this comment

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

This statement is already mentioned in extension_modules.rst. Is this required here again?

doc/overview.rst Outdated Show resolved Hide resolved
doc/synapse_models.rst Outdated Show resolved Hide resolved
doc/synapse_models.rst Outdated Show resolved Hide resolved
doc/synapse_models.rst Outdated Show resolved Hide resolved
doc/synapse_models.rst Outdated Show resolved Hide resolved
doc/synapse_models.rst Outdated Show resolved Hide resolved
clinssen and others added 2 commits January 8, 2024 14:04
Co-authored-by: Pooja Babu <75320801+pnbabu@users.noreply.github.com>
Co-authored-by: jessica-mitchell <mitchell20j@gmail.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

3 participants