Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Suggested defaults should appear on relevant decision point pages where applicable #522

Open
ahouseholder opened this issue Mar 4, 2024 · 0 comments
Labels
enhancement New feature or request

Comments

@ahouseholder
Copy link
Contributor

ahouseholder commented Mar 4, 2024

Describe the solution you'd like

(Based on a suggestion from @laurie-tyz)

We have some suggested defaults in /docs/howto/bootstrap/collect.md.

We can split them out into separate files, then include them back in this page.
This would also allow us to include them individually on their respective decision point pages, making that information accessible to readers regardless how they got there.

Describe alternatives you've considered

  • Status quo: leave the suggestions in collect.md only. It's been ok so far, but now that we're taking a more "random-access" approach to the content it seems like a little redundancy in presentation wouldn't hurt (and we can avoid content redundancy through the use of static includes.
  • Move defaults to reference pages only. This would remove relevant content from the collect.md page, and make it less useful.

Additional context

We might consider separating collect.md into separate pages, making "guidance for evidence gathering" its own page. But that would be a separate issue from this, which is just about replicating the "tip" boxes with defaults to the decision point pages.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
enhancement New feature or request
Projects
None yet
Development

No branches or pull requests

1 participant