Skip to content

doc fixes (especially new topology system)#1077

Merged
orbeckst merged 5 commits intodevelopfrom
fix-docs
Nov 19, 2016
Merged

doc fixes (especially new topology system)#1077
orbeckst merged 5 commits intodevelopfrom
fix-docs

Conversation

@orbeckst
Copy link
Member

There were no docs for the #363 changes and many reST links were broken.

Changes made in this Pull Request:

  • include all new topology code in the docs
  • fixed all broken reST such as MDAnalysis.core.AtomGroup.AtomGroup --> MDAnalysis.core.groups.AtomGroup
  • many more doc fixes...

PR Checklist

  • Docs?
  • n/a CHANGELOG updated?
  • n/a Issue raised/referenced?

Copy link
Member

@kain88-de kain88-de left a comment

Choose a reason for hiding this comment

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

Looks good besides the TODO issue


:class:`Topology` is the core object that holds all topology information.

TODO: Add in-depth discussion.
Copy link
Member

Choose a reason for hiding this comment

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

Can you make an issue for that. So we are sure to remove all TODO:s in the docs before the release

Copy link
Member Author

Choose a reason for hiding this comment

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

Raised #1078

- added rst stubs for sphinx
- updated rst docs (added links, reformatted, fixed, found out that
  Napoleon REQUIRES two lines before .. versionchanged/versionadded)
- removed AtomGroup.rst

TODO:
- explain topology system and clean up core_modules.rst (work
  for @richardjgowers and @dotsdl)
find . -name '*.rst' -print0 | xargs -0 perl -wpi~ -e 's(MDAnalysis\.core\.AtomGroup\.Universe)(MDAnalysis.core.universe.Universe)g'
find . -name '*.py' -print0 | xargs -0 perl -wpi~ -e 's(MDAnalysis\.core\.AtomGroup\.Universe)(MDAnalysis.core.universe.Universe)g'
find . -name '*.rst' -print0 | xargs -0 perl -wpi~ -e 's(MDAnalysis\.core\.AtomGroup\.AtomGroup)(MDAnalysis.core.groups.AtomGroup)g'
find . -name '*.py' -print0 | xargs -0 perl -wpi~ -e 's(MDAnalysis\.core\.AtomGroup\.AtomGroup)(MDAnalysis.core.groups.AtomGroup)g'
- AtomGroup.Atom --> groups.Atom
- AtomGroup.Merge --> universe.Merge
- AtomGroup.ResidueGroup --> groups.ResidueGroup (no SegmentGroup needed to be fixed, no Residue or Segment found)
- core.Selection --> core.selection

find . \( -name '*.py' -o -name '*.rst' \) -print0 | xargs -0 perl -wpi~ -e 's(MDAnalysis\.core\.AtomGroup\.Atom)(MDAnalysis.core.groups.Atom)g'
find . \( -name '*.py' -o -name '*.rst' \) -print0 | xargs -0 perl -wpi~ -e 's(MDAnalysis\.core\.AtomGroup\.Merge)(MDAnalysis.core.universe.Merge)g'
find . \( -name '*.py' -o -name '*.rst' \) -print0 | xargs -0 perl -wpi~ -e 's(MDAnalysis\.core\.AtomGroup\.ResidueGroup)(MDAnalysis.core.universe.ResidueGroup)g'
@orbeckst
Copy link
Member Author

rebased against develop and force-pushed

- broken reST links
- removed some of the obviously old outdated topology discussions (but
  still need proper discussion of #363 changes)
- added more cross references and SeeAlso
- even more fixes everywhere
@orbeckst orbeckst mentioned this pull request Nov 18, 2016
2 tasks
@orbeckst orbeckst merged commit 578c525 into develop Nov 19, 2016
@orbeckst orbeckst deleted the fix-docs branch November 19, 2016 03:43
abiedermann pushed a commit to abiedermann/mdanalysis that referenced this pull request Jan 5, 2017
- added missing docs for new topology system (MDAnalysis#363)
- removed some of the obviously old outdated topology discussions (but  still need proper discussion of MDAnalysis#363 changes – see issue MDAnalysis#1078 )
- added rst  sphinx stubs for new modules in core
- updated rst docs (added links, reformatted, fixed, found out that
  Napoleon REQUIRES two lines before .. versionchanged/versionadded)
- removed AtomGroup.rst
- restructured core_modules
- fixed Universe and AtomGroup reST references (core changes in MDAnalysis#363)

    find . -name '*.rst' -print0 | xargs -0 perl -wpi~ -e 's(MDAnalysis\.core\.AtomGroup\.Universe (MDAnalysis.core.universe.Universe)g'
    find . -name '*.py' -print0 | xargs -0 perl -wpi~ -e 's(MDAnalysis\.core\.AtomGroup\.Universe)(MDAnalysis.core.universe.Universe)g'
    find . -name '*.rst' -print0 | xargs -0 perl -wpi~ -e 's(MDAnalysis\.core\.AtomGroup\.AtomGroup)(MDAnalysis.core.groups.AtomGroup)g'
    find . -name '*.py' -print0 | xargs -0 perl -wpi~ -e 's(MDAnalysis\.core\.AtomGroup\.AtomGroup)(MDAnalysis.core.groups.AtomGroup)g'

- fixed reST links for other changes in core (MDAnalysis#363)
   - AtomGroup.Atom --> groups.Atom
   - AtomGroup.Merge --> universe.Merge
   - AtomGroup.ResidueGroup --> groups.ResidueGroup (no SegmentGroup needed to be fixed, no Residue or Segment found)
   - core.Selection --> core.selection

   find . \( -name '*.py' -o -name '*.rst' \) -print0 | xargs -0 perl -wpi~ -e 's(MDAnalysis\.core\.AtomGroup\.Atom)(MDAnalysis.core.groups.Atom)g'
   find . \( -name '*.py' -o -name '*.rst' \) -print0 | xargs -0 perl -wpi~ -e 's(MDAnalysis\.core\.AtomGroup\.Merge)(MDAnalysis.core.universe.Merge)g'
   find . \( -name '*.py' -o -name '*.rst' \) -print0 | xargs -0 perl -wpi~ -e 's(MDAnalysis\.core\.AtomGroup\.ResidueGroup)(MDAnalysis.core.universe.ResidueGroup)g'

- many more doc fixes everywhere
   - broken reST links
   - added more cross references and SeeAlso
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants