bcgov / MFIN-Data-Catalogue

The Finance Data Catalogue enables users to discover data holdings at the BC Ministry of Finance and offers information and functionality that benefits consumers of data for business purposes. The product is built using Drupal and adheres to the Government of BC's Core Administrative and Descriptive etadata Standard.
Other
6 stars 0 forks source link

Documentation updates #377

Closed CraigClark closed 5 months ago

CraigClark commented 7 months ago

OP timer

https://openplus.monday.com/boards/4092908516/pulses/6200666243


There have been several changes since the documentation was written. It needs a full review and some sections need to be added.

[!IMPORTANT] Pay close attention to the use of the phrase data set. It has been used interchangeably with a lot of other terminology. Data set could refer to:

  • Metadata record
  • asset
  • data, report or form
CraigClark commented 6 months ago

re:

add a section on API, most of the API docs are in the wiki, but we should have a view that lists all the IDs people might need for creating/editing records via the API

I talked to Joel about this. The best way is not a view, but to create a feed. Since MFIN has no plans at the moment to manage records via API, we will not be building the feed. I did mention in the documentation that one should be added when JSON API is used to create/update records.

CraigClark commented 6 months ago

for this _add info to the wiki on setting values in the dcmodule. Reference it from the documentation admin, I added the info to docs in the data catalogue instead. This is because #397 moves configuring the custom module to the UI where it can be managed by DC admins.

CraigClark commented 6 months ago

Bookmarks and notification will be rolled into the same doc because notification depends on a record being bookmarked.

CraigClark commented 6 months ago

'who to contact' is content added to the front page of the help guide.

CraigClark commented 6 months ago

docs for running tests are here https://github.com/bcgov/MFIN-Data-Catalogue/wiki/Test-plan

CraigClark commented 6 months ago

Assigning to @lkmorlan for Only authenticated users can access documentation (book content type)

Assigning to @NicoledeGreef for update security classification