aiida-core icon indicating copy to clipboard operation
aiida-core copied to clipboard

Docs: remove old content from 'developer_guide/'

Open ramirezfranciscof opened this issue 4 years ago • 3 comments

This is a structure that was left over from the old documentation and needs to be removed, but first we need to check if all the content has been re-assigned in the new documentation. The files considered are:

Proposition:

Most of this content seems to be appropriate for the internals section:

  • Global design: design/changes.rst
  • RestAPI: core/extend_restapi.rst
  • ~~DB schema: core/modifying_the_schema.rst~~
  • ~~Entities: core/internals.rst~~
  • ~~[Engine: core/caching.rst? I think it contains mostly info about the internals of the caching mechanism, but just in case it might be also considered altogether with this issue.~~

See comments for strikethrough sections.

The only exception being:

Since the internals are not a priority right now, I wonder if we should just copy this pages into these new placeholders and leave it there until those sections are tackled so that we can remove the old structure from the repository. Alternatively we could put the files inside of internals/global_design.src folders if we don't want to display unfinished content in the documentation.

ramirezfranciscof avatar Oct 16 '20 10:10 ramirezfranciscof