Skip to content
This repository has been archived by the owner on Aug 22, 2022. It is now read-only.

Documentation compilation #96

Open
1 of 15 tasks
CSDUMMI opened this issue Apr 19, 2021 · 6 comments
Open
1 of 15 tasks

Documentation compilation #96

CSDUMMI opened this issue Apr 19, 2021 · 6 comments

Comments

@CSDUMMI
Copy link

CSDUMMI commented Apr 19, 2021

Currently, the Documentation of OrbitDB is hosted on GitHub
in the various Repositories.

But this makes them very hard to search and reference quickly.

I propose, that we compile all of these documentation
files into a single easy to reference repository, that can then be put
up in a cook book.

Either by hand once or via a script.

TODO:

  • Copy API.md and GUIDE.md
  • Merge orbit-db README with API.md
  • Merge orbit-db-store README with API.md
  • Merge orbit-db-feedstore README with API.md
  • Merge orbit-db-eventstore
  • Merge orbit-db-docstore
  • Merge orbit-db-kvstore
  • Merge orbit-db-counterstore
  • Merge crdts
  • Merge orbit-db-pubsub
  • Merge orbit-db-cache
  • Merge orbit-db-identity-provider
  • Merge orbit-db-keystore
  • Merge orbit-db-io
  • Merge ipfs-log
@CSDUMMI
Copy link
Author

CSDUMMI commented Apr 19, 2021

After we made this compilation, the documentation in the repositories READMEs are discontinued
and prefaced with a link to the relevant pages in the Documentations Repository/Page.

@aphelionz
Copy link
Contributor

I think we should make a new Section of the Field Manual called "Cookbook" after the Tutorial https://github.com/orbitdb/field-manual

@CSDUMMI
Copy link
Author

CSDUMMI commented Apr 19, 2021

That would be a position, that people would expect it to be, wouldn't they?

Is the Field Manual already compiled into a web page?

If so, this would be the way that I would want this to go.

@CSDUMMI
Copy link
Author

CSDUMMI commented Apr 19, 2021

But I also want to move the different README Files of all the Repos into the API.md file.

@CSDUMMI
Copy link
Author

CSDUMMI commented Apr 19, 2021

Currently, the Documentation of OrbitDB is hosted on GitHub
in the various Repositories.

But this makes them very hard to search and reference quickly.

I propose, that we compile all of these documentation
files into a single easy to reference repository, that can then be put
up in a cook book.

Either by hand once or via a script.

TODO:

  • Copy API.md and GUIDE.md
  • Merge orbit-db README with API.md
  • Merge orbit-db-store README with API.md
  • Merge orbit-db-feedstore README with API.md
  • Merge orbit-db-eventstore
  • Merge orbit-db-docstore
  • Merge orbit-db-kvstore
  • Merge orbit-db-counterstore
  • Merge crdts
  • Merge orbit-db-pubsub
  • Merge orbit-db-cache
  • Merge orbit-db-identity-provider
  • Merge orbit-db-keystore
  • Merge orbit-db-io
  • Merge ipfs-log

@CSDUMMI CSDUMMI closed this as completed Apr 19, 2021
@CSDUMMI CSDUMMI reopened this Apr 19, 2021
@aphelionz
Copy link
Contributor

Is the Field Manual already compiled into a web page?

No, but it could be. Moving everything to API.md would be a good step in the right direction too.

Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants