Skip to content

refactor: Rename "docs" directory to "website"#27438

Open
Josmithr wants to merge 12 commits into
microsoft:mainfrom
Josmithr:rename-docs-directory
Open

refactor: Rename "docs" directory to "website"#27438
Josmithr wants to merge 12 commits into
microsoft:mainfrom
Josmithr:rename-docs-directory

Conversation

@Josmithr
Copy link
Copy Markdown
Contributor

In preparation to add repo "wiki" documentation under a directory called "docs".

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented May 28, 2026

Hi! Thank you for opening this PR. Want me to review it?

Based on the diff (134 lines, 207 files), I've queued these reviewers:

  • Correctness — logic errors, race conditions, lifecycle issues
  • Security — vulnerabilities, secret exposure, injection
  • API Compatibility — breaking changes, release tags, type design
  • Performance — algorithmic regressions, memory leaks
  • Testing — coverage gaps, hollow tests

How this works

  • Adjust the reviewer set by ticking/unticking boxes above. Reviewer toggles alone don't trigger anything.

  • Tick Start review below to dispatch the review fleet.

  • After review finishes, tick Start review again to request another run — it auto-resets after each dispatch.

  • This comment updates as new commits land; your reviewer selections are preserved.

  • Start review

Comment thread website/src/theme/NavbarItem/DocsVersionDropdownNavbarItem.tsx Outdated
Comment thread website/infra/api-markdown-documenter/api-documentation-layout.mjs Outdated
Comment thread website/infra/api-markdown-documenter/api-documentation-layout.mjs Outdated
Comment thread website/infra/api-markdown-documenter/api-documentation-layout.mjs Outdated
Co-authored-by: Joshua Smithrud <54606601+Josmithr@users.noreply.github.com>
Comment thread website/infra/api-markdown-documenter/render-api-documentation.mjs Outdated
Comment thread website/infra/api-markdown-documenter/render-api-documentation.mjs Outdated
Co-authored-by: Joshua Smithrud <54606601+Josmithr@users.noreply.github.com>
Comment thread website/infra/api-markdown-documenter/render-api-documentation.mjs Outdated
@Josmithr Josmithr changed the title [DRAFT] refactor: Rename "docs" directory to "website" refactor: Rename "docs" directory to "website" Jun 4, 2026
@Josmithr Josmithr requested a review from alexvy86 June 4, 2026 00:06
Comment thread .github/labeler-areas.yml
@@ -124,7 +124,9 @@ dependencies:

documentation:
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Not necessarily for this PR but maybe this label should change too?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I was actually assuming this would expand to include things we put under the new docs directory. So this would be reviewers of any documentation content (versus the website one above). Or maybe we would want those to be distinct. But yeah, probably a conversation for the future.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nit: would love to rename this file too but that's a bit more intricate; I think we'd have to create the new file as a copy, go to ADO and re-point the pipeline, then delete the old file. Not sure how it would impact branches other than main... we don't tend (should?) touch the docs(website) folder in other branches, right?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yeah, fair point. I think I would prefer to do that as a separate PR, but probably worth doing.

Not sure how it would impact branches other than main... we don't tend (should?) touch the docs(website) folder in other branches, right?

We shouldn't be making website changes on other branches - those changes wouldn't go anywhere. But I don't know if we currently build on those branches or not. Would need to be verified.

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Jun 5, 2026

🔗 No broken links found! ✅

Your attention to detail is admirable.

linkcheck output


> fluid-framework-website@0.0.0 ci:check-links /home/runner/work/FluidFramework/FluidFramework/website
> start-server-and-test "npm run serve -- --no-open" 3000 check-links

1: starting server using command "npm run serve -- --no-open"
and when url "[ 'http://127.0.0.1:3000' ]" is responding with HTTP status code 200
running tests using command "npm run check-links"


> fluid-framework-website@0.0.0 serve
> docusaurus serve --no-open

[SUCCESS] Serving "build" directory at: http://localhost:3000/

> fluid-framework-website@0.0.0 check-links
> linkcheck http://localhost:3000 --skip-file skipped-urls.txt

Crawling...

Stats:
  290871 links
    1933 destination URLs
    2183 URLs ignored
       0 warnings
       0 errors


@Josmithr Josmithr marked this pull request as ready for review June 5, 2026 20:53
Copilot AI review requested due to automatic review settings June 5, 2026 20:53
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot reviewed 10 out of 207 changed files in this pull request and generated no comments.

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Jun 5, 2026

🔗 No broken links found! ✅

Your attention to detail is admirable.

linkcheck output


> fluid-framework-website@0.0.0 ci:check-links /home/runner/work/FluidFramework/FluidFramework/website
> start-server-and-test "npm run serve -- --no-open" 3000 check-links

1: starting server using command "npm run serve -- --no-open"
and when url "[ 'http://127.0.0.1:3000' ]" is responding with HTTP status code 200
running tests using command "npm run check-links"


> fluid-framework-website@0.0.0 serve
> docusaurus serve --no-open

[SUCCESS] Serving "build" directory at: http://localhost:3000/

> fluid-framework-website@0.0.0 check-links
> linkcheck http://localhost:3000 --skip-file skipped-urls.txt

Crawling...

Stats:
  290871 links
    1933 destination URLs
    2183 URLs ignored
       0 warnings
       0 errors


Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants