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

Documentation

Open sadasant opened this issue 7 years ago • 5 comments

In all of the repos related to contexture. Let's start from a usage perspective, then after that, think about other internal things that might benefit from being documented.

sadasant avatar May 23 '18 22:05 sadasant

One way to do this would be:

  1. Start with the new contexture-imdb.
  2. Every time you find you'll need to read the source code, point it out as "need to provide documentation".

sadasant avatar May 23 '18 22:05 sadasant

Another thing needed:

  • More robust type authoring guide.

sadasant avatar May 23 '18 22:05 sadasant

Here's what I have: https://github.com/smartprocure/contexture-docs/pull/1 You can explore it using: https://github.com/smartprocure/contexture-docs/tree/draft

Some of the files are missing, but it should be our culture to work on these documents as we use and work on contexture repositories.

Also: having this as a separate documentation repo seems necessary since Contexture is so separated in different pieces.

sadasant avatar Jun 05 '18 21:06 sadasant

Taking this since the PR is assigned to me for review

daedalus28 avatar Jun 20 '18 18:06 daedalus28

Created two PRs to address this issue, one using Gitbook and one using Flatdoc, to compare and pick which format is better:

  • https://github.com/smartprocure/contexture-docs/pull/5
  • https://github.com/smartprocure/contexture-docs/pull/4

vyrnix9582046173 avatar Mar 09 '20 03:03 vyrnix9582046173