Skip to content

Remove reuse directory#576

Merged
jahn-junior merged 7 commits into
mainfrom
docpr-2393-resuse
May 1, 2026
Merged

Remove reuse directory#576
jahn-junior merged 7 commits into
mainfrom
docpr-2393-resuse

Conversation

@nhennigan

@nhennigan nhennigan commented Apr 6, 2026

Copy link
Copy Markdown
Contributor

Description

We have been asked to remove the resue directory to reduce the overall complexity of the starter pack. This PR remove the directory, moves the relevant files into new locations and updates references to the directory.

Solution

  • Removed reuse/ dir

  • Moved mermaid.txt and components.yaml to /assets dir

  • Updated references in the docs. The user can create their own reuse dir if they have the need for one

  • Updated conf.py

    • It checks for substitutions.txt or just loads variables straight from conf.py
    • Removed trailing whitespace
    • rst_epilog is set to local variables rather than substitutions.txt
  • Added links from link.txt to the relevant docs

  • Have you updated CHANGELOG.md with relevant non-documentation file changes?

  • Have you updated the documentation for this change?


@jahn-junior jahn-junior added the breaking change PR introduces a breaking change. label Apr 6, 2026

@jahn-junior jahn-junior left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Thanks, @nhennigan! Everything seems to build and render just fine.

I left one suggestion, but it isn't a blocker.

Comment thread docs/how-to/configure-your-project.rst Outdated

@medubelko medubelko left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Comment thread CHANGELOG.md Outdated
Comment thread docs/explanation/assets/components.yaml
Comment thread docs/how-to/contributing.rst Outdated
Comment thread docs/how-to/configure-your-project.rst Outdated
Comment thread docs/reference/index.rst Outdated
Comment thread docs/reference/index.rst Outdated
Remove the reuse directory. Update all links from links.txt into the individual files. Move the substitutions to the conf.py. Update the docs that pointed to the reuse dir components. Move mermaid code and component code to assets dir
Move rst links to line as they are once off links. Updated CHANGELOG. Removed files that were deleted on main that remained after rebase. Address other minor review comments

@medubelko medubelko left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

All my comments are addressed. Thanks @nhennigan!

@jahn-junior jahn-junior added the Awaiting release Will be merged for the next minor release. label Apr 24, 2026
@jahn-junior

Copy link
Copy Markdown
Collaborator

Test failures unrelated to changes.

@jahn-junior jahn-junior merged commit c20d6ba into main May 1, 2026
6 of 9 checks passed
@jahn-junior jahn-junior deleted the docpr-2393-resuse branch May 1, 2026 01:57
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Awaiting release Will be merged for the next minor release. breaking change PR introduces a breaking change.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants