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

Mkdocs candidate #18

Merged
merged 3 commits into from
Jan 10, 2015
Merged

Mkdocs candidate #18

merged 3 commits into from
Jan 10, 2015

Conversation

tshort
Copy link
Owner

@tshort tshort commented Jan 10, 2015

The documentation structure is pretty well set now. I like the way it works. Lots of changes here:

  • Code now has inline documentation for all user code and models
    using Docile. Should work with Julia 0.4 with some tweaks.
  • Reorganize lib into a top-level directory and put it in a Sims.Lib
    module.
  • Reorganize docs and examples into top-level directories.
  • Included examples in a Sims.Examples module with the following modules.
    • Sims.Examples.Basics
    • Sims.Examples.Lib
    • Sims.Examples.Neural
  • Removed all plotting and simulation commands from examples.
  • Added a runexamples function in each of the examples modules.
  • Added a script to build the docs. The contents of the following
    directories are automatically generated:
    docs/api
    docs/lib
    docs/examples
  • Added documentation on plotting results.
  • Removed the /doc folder and added a /docs Mkdocs documentation folder.
  • Added an mkdocs.yml folder and a docs/css/github.css file for
    syntax highlighting.

* Code now has inline documentation for all user code and models
  using Docile. Should work with Julia 0.4 with some tweaks.

* Reorganize lib into a top-level directory and put it in a Sims.Lib
  module.

* Reorganize docs and examples into top-level directories.

* Included examples in a Sims.Examples module with the following modules.
  * Sims.Examples.Basics
  * Sims.Examples.Lib
  * Sims.Examples.Neural

* Removed all plotting and simulation commands from examples.

* Added a `runexamples` function in each of the examples modules.

* Added a script to build the docs. The contents of the following
  directories are automatically generated:
    docs/api
    docs/lib
    docs/examples

* Added documentation on plotting results.

* Removed the /doc folder and added a /docs Mkdocs documentation folder.

* Added an mkdocs.yml folder and a docs/css/github.css file for
  syntax highlighting.
…s-candidate

Fixed conflicts:
	examples/basics/vanderpol_with_events.jl
	examples/neural/hh.jl
	src/dassl.jl
@tshort
Copy link
Owner Author

tshort commented Jan 10, 2015

For issue #10.

iraikov added a commit that referenced this pull request Jan 10, 2015
@iraikov iraikov merged commit 9dd2249 into master Jan 10, 2015
@tshort tshort deleted the mkdocs-candidate branch January 10, 2015 23:40
@tshort
Copy link
Owner Author

tshort commented Jan 10, 2015

@iraikov, if you want to add docs to more of your your neural examples and include them in Sims.Examples.Neural, please do. Let me know if you have questions on the format. Hopefully, you can just copy what I did in other places.

I'd like to tag a release soon, so let me know if there's anything you'd like to do before we tag a release.

@iraikov
Copy link
Collaborator

iraikov commented Jan 11, 2015

Hi Tom,

I am currently trying to figure out if I can use InitialEquation to

initialize states and parameters when a structural event occurs.
So let me see if I can improve the initial equation functionality a little
bit before you tag the release. Thanks,

Ivan

On Sat, Jan 10, 2015 at 3:45 PM, Tom Short [email protected] wrote:

@iraikov https://github.com/iraikov, if you want to add docs to more of
your your neural examples and include them in Sims.Examples.Neural, please
do. Let me know if you have questions on the format. Hopefully, you can
just copy what I did in other places.

I'd like to tag a release soon, so let me know if there's anything you'd
like to do before we tag a release.


Reply to this email directly or view it on GitHub
#18 (comment).

@tshort
Copy link
Owner Author

tshort commented Jan 11, 2015

Ok. That functionality is likely to be weak. Let me know how it goes.

On Sat, Jan 10, 2015 at 7:26 PM, Ivan Raikov [email protected]
wrote:

Hi Tom,

I am currently trying to figure out if I can use InitialEquation to
initialize states and parameters when a structural event occurs.
So let me see if I can improve the initial equation functionality a little
bit before you tag the release. Thanks,

Ivan

On Sat, Jan 10, 2015 at 3:45 PM, Tom Short [email protected]
wrote:

@iraikov https://github.com/iraikov, if you want to add docs to more
of
your your neural examples and include them in Sims.Examples.Neural,
please
do. Let me know if you have questions on the format. Hopefully, you can
just copy what I did in other places.

I'd like to tag a release soon, so let me know if there's anything you'd
like to do before we tag a release.


Reply to this email directly or view it on GitHub
#18 (comment).


Reply to this email directly or view it on GitHub
#18 (comment).

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.

2 participants