Add Department and Location docs for 3.1 - #78
Conversation
Publish the Department concept and four flows, and the Location concept and six flows, from the care_docs sources. Both sit as module categories under Flows > Facility.
Deploying coredocs with
|
| Latest commit: |
abf4b95
|
| Status: | ✅ Deploy successful! |
| Preview URL: | https://f6e9c4b5.coredocs.pages.dev |
| Branch Preview URL: | https://docs-facility-department-loc.coredocs.pages.dev |
![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?s=60&v=4){kind=small}
There was a problem hiding this comment.
Generated by Docs Reviewer for #78 · opus50 · 114.4 AIC · ⌖ 9.61 AIC · ⊞ 11K
|
|
||
| ## Definition | ||
|
|
||
| A **[department](https://build.fhir.org/organization.html)** in Care is a group inside a facility, such as a ward, a clinical team, or an administrative unit. A department can hold sub-departments, so the departments of a facility form a hierarchy. Care models a department on the FHIR Organization resource. |
There was a problem hiding this comment.
Checklist item 7 (FHIR): linking the FHIR resource page is right, but narrating the mapping is not. Please drop the final sentence — "Care models a department on the FHIR Organization resource." The link on department already carries that.
| --- | ||
|
|
||
| # Location | ||
| # Locations |
There was a problem hiding this comment.
Mirroring (conventions, "Mirror 3.0 → 3.1", checklist item 11): this rewrite lands only in version-3.1. versioned_docs/version-3.0/concepts/facility/location.mdx still holds the old page, so the two versions diverge. Please mirror this file — and the new concepts/facility/department.mdx — into version-3.0.
| | Permission | Access | | ||
| | --- | --- | | ||
| | Can Create/Update Facility Locations | Lets you link and unlink departments on the location. | | ||
|
|
There was a problem hiding this comment.
Factual hygiene (checklist 16): linking and unlinking organizations on a location is gated by its own permission, not can_write_facility_locations. care/security/permissions/location.py defines Can List Facility Location Organizations and Can Create/Update Facility Location Organizations (Facility Admin, Admin, Staff). Please list those two here instead of "Can Create/Update Facility Locations".
| Care's location aligns with the FHIR [Location](https://build.fhir.org/location.html) resource, including its mode (`kind` / `instance`), physical-form codes, and operational-status codes for beds and rooms. | ||
| - Flow: [Create a location](../../flows/facility/location/create-location.mdx) | ||
| - Flow: [View locations](../../flows/facility/location/view-locations.mdx) | ||
| - Flow: [Edit a location](../../flows/facility/location/edit-location.mdx) |
There was a problem hiding this comment.
The Related list drops the technical reference link. The concept skill requires Related to always carry the matching reference, and references/facility/location.mdx exists. Please re-add - Reference: [Location](../../references/facility/location.mdx), plus the sibling concept links that were removed (Facility, Facility organization, Encounter).
1 participant
What
Publishes the Department and Location documentation from
care_docsinto the docs site (version 3.1).Department (new)
concepts/facility/department.mdxflows/facility/department/:Location
concepts/facility/location.mdxwith the authored versionflows/facility/location/:Both sit as sibling module categories under
Flows > Facility, beside the existingFacilitymodule.Notes for reviewers
location), matching the sibling concepts Facility, Device and Healthcare Service.concepts/access-governance/facility-organization.mdx.Verification
Docusaurus build passes for both
enandmllocales.