From b9a194f7c5a684105646f771a79bcb01aa239d2f Mon Sep 17 00:00:00 2001 From: Jaime Meza Date: Thu, 18 Jun 2026 14:50:15 -0500 Subject: [PATCH] =?UTF-8?q?docs:=20reorganize=20site=20structure=20using?= =?UTF-8?q?=20Di=C3=A1taxis=20framework?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Group hub-documentation into explanation/, how-to/, and reference/ per Diátaxis - Move ifs-integration.md to new hoist-hub/ category - Add contributing/ category with Diátaxis framework explainer - Move tutorial-basics and tutorial-extras under docusaurus-guide/ - Rewrite docs/intro.mdx as site entry point with category navigation - Update all doc titles to reflect their Diátaxis type - Add HOIST logo to homepage hero and fix Get Started link --- docs/contributing/_category_.json | 8 +++ docs/contributing/diataxis-framework.md | 38 ++++++++++++++ docs/docusaurus-guide/_category_.json | 8 +++ docs/docusaurus-guide/intro.mdx | 47 +++++++++++++++++ .../tutorial-basics/_category_.json | 2 +- .../tutorial-basics/congratulations.mdx | 0 .../tutorial-basics/create-a-blog-post.mdx | 0 .../tutorial-basics/create-a-document.mdx | 0 .../tutorial-basics/create-a-page.mdx | 0 .../tutorial-basics/deploy-your-site.mdx | 0 .../tutorial-basics/markdown-features.mdx | 10 ++-- .../tutorial-extras/_category_.json | 2 +- .../img/docsVersionDropdown.png | Bin .../tutorial-extras/img/localeDropdown.png | Bin .../tutorial-extras/manage-docs-versions.mdx | 0 .../tutorial-extras/translate-your-site.mdx | 0 docs/hoist-hub/_category_.json | 8 +++ .../ifs-integration.md | 6 ++- docs/hub-documentation/_category_.json | 8 ++- .../delivery/_category_.json | 4 -- .../explanation/_category_.json | 8 +++ .../{overview => explanation}/purpose.md | 2 +- .../{overview => explanation}/roles.md | 0 docs/hub-documentation/how-to/_category_.json | 8 +++ .../document-custom-fields.md} | 2 +- .../mockups.md => how-to/document-mockups.md} | 2 +- .../ui-flow.md => how-to/document-ui-flow.md} | 2 +- .../integration/_category_.json | 4 -- .../overview/_category_.json | 4 -- .../hub-documentation/process/_category_.json | 4 -- .../reference/_category_.json | 8 +++ .../{delivery => reference}/approvals.md | 2 +- .../business-requirements.md | 0 .../{delivery => reference}/change-log.md | 0 .../{delivery => reference}/estimates.md | 2 +- .../functional-design.md | 0 .../technical-design.md | 0 .../{delivery => reference}/test-plan.md | 2 +- .../specification/_category_.json | 4 -- docs/intro.mdx | 48 +++++++++--------- src/pages/index.module.css | 13 +++++ src/pages/index.tsx | 7 ++- ...{White Hoist Logo.avif => hoist-logo.avif} | Bin static/img/hoist-partner-logo.png | Bin 15164 -> 0 bytes 44 files changed, 200 insertions(+), 63 deletions(-) create mode 100644 docs/contributing/_category_.json create mode 100644 docs/contributing/diataxis-framework.md create mode 100644 docs/docusaurus-guide/_category_.json create mode 100644 docs/docusaurus-guide/intro.mdx rename docs/{ => docusaurus-guide}/tutorial-basics/_category_.json (90%) rename docs/{ => docusaurus-guide}/tutorial-basics/congratulations.mdx (100%) rename docs/{ => docusaurus-guide}/tutorial-basics/create-a-blog-post.mdx (100%) rename docs/{ => docusaurus-guide}/tutorial-basics/create-a-document.mdx (100%) rename docs/{ => docusaurus-guide}/tutorial-basics/create-a-page.mdx (100%) rename docs/{ => docusaurus-guide}/tutorial-basics/deploy-your-site.mdx (100%) rename docs/{ => docusaurus-guide}/tutorial-basics/markdown-features.mdx (92%) rename docs/{ => docusaurus-guide}/tutorial-extras/_category_.json (82%) rename docs/{ => docusaurus-guide}/tutorial-extras/img/docsVersionDropdown.png (100%) rename docs/{ => docusaurus-guide}/tutorial-extras/img/localeDropdown.png (100%) rename docs/{ => docusaurus-guide}/tutorial-extras/manage-docs-versions.mdx (100%) rename docs/{ => docusaurus-guide}/tutorial-extras/translate-your-site.mdx (100%) create mode 100644 docs/hoist-hub/_category_.json rename docs/{hub-documentation/integration => hoist-hub}/ifs-integration.md (98%) delete mode 100644 docs/hub-documentation/delivery/_category_.json create mode 100644 docs/hub-documentation/explanation/_category_.json rename docs/hub-documentation/{overview => explanation}/purpose.md (97%) rename docs/hub-documentation/{overview => explanation}/roles.md (100%) create mode 100644 docs/hub-documentation/how-to/_category_.json rename docs/hub-documentation/{process/custom-fields.md => how-to/document-custom-fields.md} (97%) rename docs/hub-documentation/{process/mockups.md => how-to/document-mockups.md} (98%) rename docs/hub-documentation/{process/ui-flow.md => how-to/document-ui-flow.md} (99%) delete mode 100644 docs/hub-documentation/integration/_category_.json delete mode 100644 docs/hub-documentation/overview/_category_.json delete mode 100644 docs/hub-documentation/process/_category_.json create mode 100644 docs/hub-documentation/reference/_category_.json rename docs/hub-documentation/{delivery => reference}/approvals.md (98%) rename docs/hub-documentation/{specification => reference}/business-requirements.md (100%) rename docs/hub-documentation/{delivery => reference}/change-log.md (100%) rename docs/hub-documentation/{delivery => reference}/estimates.md (98%) rename docs/hub-documentation/{specification => reference}/functional-design.md (100%) rename docs/hub-documentation/{specification => reference}/technical-design.md (100%) rename docs/hub-documentation/{delivery => reference}/test-plan.md (98%) delete mode 100644 docs/hub-documentation/specification/_category_.json rename static/img/{White Hoist Logo.avif => hoist-logo.avif} (100%) delete mode 100644 static/img/hoist-partner-logo.png diff --git a/docs/contributing/_category_.json b/docs/contributing/_category_.json new file mode 100644 index 0000000..6560c02 --- /dev/null +++ b/docs/contributing/_category_.json @@ -0,0 +1,8 @@ +{ + "label": "Contributing", + "position": 4, + "link": { + "type": "generated-index", + "description": "Guidelines for contributing to and maintaining this documentation site." + } +} diff --git a/docs/contributing/diataxis-framework.md b/docs/contributing/diataxis-framework.md new file mode 100644 index 0000000..9f70362 --- /dev/null +++ b/docs/contributing/diataxis-framework.md @@ -0,0 +1,38 @@ +--- +sidebar_position: 3 +title: Documentation Framework (Diátaxis) +--- + +# Documentation Framework (Diátaxis) + +This documentation site is structured using the [Diátaxis framework](https://diataxis.fr/) — a systematic approach to technical documentation that organizes content around user needs rather than product structure. + +## The Core Idea + +Documentation serves different purposes depending on what the reader needs at a given moment. Diátaxis identifies four distinct needs and maps them to four types of documentation: + +| Type | Answers | Reader is... | +|---|---|---| +| **Explanation** | "Why does this work this way?" | Seeking understanding | +| **How-to Guide** | "How do I accomplish X?" | Solving a specific problem | +| **Reference** | "What exactly does this field/section require?" | Consulting while working | +| **Tutorial** | "How do I learn this from scratch?" | Learning for the first time | + +## How This Site Uses Diátaxis + +### Explanation +Content that provides context, background, and reasoning. Read this to understand the *why* behind the HUB Spec Standard — its purpose, the roles involved, and the architectural decisions behind IFS integration. + +### How-to Guides +Step-by-step guidance for specific documentation tasks. Read these when you know *what* you need to document but need direction on *how* to do it correctly — such as documenting a UI flow, mockups, or custom fields. + +### Reference +Templates and structural standards for every section of a HUB spec. Consult these *while writing* a spec — they define what each section must contain, what fields are required, and how tables should be structured. + +## Why This Matters + +Mixing documentation types is one of the most common causes of poor documentation. A reference page that tries to also teach and guide becomes hard to navigate. A how-to guide bloated with background theory loses its usefulness when someone needs a quick answer. + +By keeping each type separate and clearly labeled, every reader — whether a new Business Analyst or an experienced Developer — can find exactly what they need without reading everything. + +For a deeper understanding of the framework, visit [diataxis.fr](https://diataxis.fr/). diff --git a/docs/docusaurus-guide/_category_.json b/docs/docusaurus-guide/_category_.json new file mode 100644 index 0000000..62f50c1 --- /dev/null +++ b/docs/docusaurus-guide/_category_.json @@ -0,0 +1,8 @@ +{ + "label": "Docusaurus Guide", + "position": 5, + "link": { + "type": "generated-index", + "description": "Learn how to work with Docusaurus — create pages, write docs, manage versions, and deploy the site." + } +} diff --git a/docs/docusaurus-guide/intro.mdx b/docs/docusaurus-guide/intro.mdx new file mode 100644 index 0000000..88f9571 --- /dev/null +++ b/docs/docusaurus-guide/intro.mdx @@ -0,0 +1,47 @@ +--- +sidebar_position: 1 +--- + +# Tutorial Intro + +Let's discover **Docusaurus in less than 5 minutes**. + +## Getting Started + +Get started by **creating a new site**. + +Or **try Docusaurus immediately** with **[docusaurus.new](https://docusaurus.new)**. + +### What you'll need + +- [Node.js](https://nodejs.org/en/download/) version 20.0 or above: + - When installing Node.js, you are recommended to check all checkboxes related to dependencies. + +## Generate a new site + +Generate a new Docusaurus site using the **classic template**. + +The classic template will automatically be added to your project after you run the command: + +```bash +npm init docusaurus@latest my-website classic +``` + +You can type this command into Command Prompt, Powershell, Terminal, or any other integrated terminal of your code editor. + +The command also installs all necessary dependencies you need to run Docusaurus. + +## Start your site + +Run the development server: + +```bash +cd my-website +npm run start +``` + +The `cd` command changes the directory you're working with. In order to work with your newly created Docusaurus site, you'll need to navigate the terminal there. + +The `npm run start` command builds your website locally and serves it through a development server, ready for you to view at http://localhost:3000/. + +Open `docs/intro.md` (this page) and edit some lines: the site **reloads automatically** and displays your changes. diff --git a/docs/tutorial-basics/_category_.json b/docs/docusaurus-guide/tutorial-basics/_category_.json similarity index 90% rename from docs/tutorial-basics/_category_.json rename to docs/docusaurus-guide/tutorial-basics/_category_.json index 2e6db55..79e99bc 100644 --- a/docs/tutorial-basics/_category_.json +++ b/docs/docusaurus-guide/tutorial-basics/_category_.json @@ -1,6 +1,6 @@ { "label": "Tutorial - Basics", - "position": 2, + "position": 1, "link": { "type": "generated-index", "description": "5 minutes to learn the most important Docusaurus concepts." diff --git a/docs/tutorial-basics/congratulations.mdx b/docs/docusaurus-guide/tutorial-basics/congratulations.mdx similarity index 100% rename from docs/tutorial-basics/congratulations.mdx rename to docs/docusaurus-guide/tutorial-basics/congratulations.mdx diff --git a/docs/tutorial-basics/create-a-blog-post.mdx b/docs/docusaurus-guide/tutorial-basics/create-a-blog-post.mdx similarity index 100% rename from docs/tutorial-basics/create-a-blog-post.mdx rename to docs/docusaurus-guide/tutorial-basics/create-a-blog-post.mdx diff --git a/docs/tutorial-basics/create-a-document.mdx b/docs/docusaurus-guide/tutorial-basics/create-a-document.mdx similarity index 100% rename from docs/tutorial-basics/create-a-document.mdx rename to docs/docusaurus-guide/tutorial-basics/create-a-document.mdx diff --git a/docs/tutorial-basics/create-a-page.mdx b/docs/docusaurus-guide/tutorial-basics/create-a-page.mdx similarity index 100% rename from docs/tutorial-basics/create-a-page.mdx rename to docs/docusaurus-guide/tutorial-basics/create-a-page.mdx diff --git a/docs/tutorial-basics/deploy-your-site.mdx b/docs/docusaurus-guide/tutorial-basics/deploy-your-site.mdx similarity index 100% rename from docs/tutorial-basics/deploy-your-site.mdx rename to docs/docusaurus-guide/tutorial-basics/deploy-your-site.mdx diff --git a/docs/tutorial-basics/markdown-features.mdx b/docs/docusaurus-guide/tutorial-basics/markdown-features.mdx similarity index 92% rename from docs/tutorial-basics/markdown-features.mdx rename to docs/docusaurus-guide/tutorial-basics/markdown-features.mdx index 3085337..2d74ae2 100644 --- a/docs/tutorial-basics/markdown-features.mdx +++ b/docs/docusaurus-guide/tutorial-basics/markdown-features.mdx @@ -59,18 +59,18 @@ Let's see how to [Create a page](./create-a-page.mdx). Regular Markdown images are supported. -You can use absolute paths to reference images in the static directory (`static/img/hoist-partner-logo.png`): +You can use absolute paths to reference images in the static directory (`static/img/hoist-logo.avif`): ```md -![Docusaurus logo](/img/hoist-partner-logo.png) +![Docusaurus logo](/img/hoist-logo.avif) ``` -![Docusaurus logo](/img/hoist-partner-logo.png) +![Docusaurus logo](/img/hoist-logo.avif) You can reference images relative to the current file as well. This is particularly useful to colocate images close to the Markdown files using them: ```md -![Docusaurus logo](./img/hoist-partner-logo.png) +![Docusaurus logo](./img/hoist-logo.avif) ``` ## Code Blocks @@ -147,7 +147,7 @@ This is Docusaurus green ! This is Facebook blue ! ``` -export const Highlight = ({children, color}) => ( +export const Highlight = ({ children, color }) => (
+ HOIST Logo {siteConfig.title}

{siteConfig.tagline}

+ to="/docs/intro"> Get Started
diff --git a/static/img/White Hoist Logo.avif b/static/img/hoist-logo.avif similarity index 100% rename from static/img/White Hoist Logo.avif rename to static/img/hoist-logo.avif diff --git a/static/img/hoist-partner-logo.png b/static/img/hoist-partner-logo.png deleted file mode 100644 index 5417f1246ca73ce133658130da8c4115e27a9876..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 15164 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