Skip to content

Update documentation sections#778

Open
olgahryniuk wants to merge 8 commits intoinput-output-hk:mainfrom
olgahryniuk:patch-32
Open

Update documentation sections#778
olgahryniuk wants to merge 8 commits intoinput-output-hk:mainfrom
olgahryniuk:patch-32

Conversation

@olgahryniuk
Copy link
Contributor

@olgahryniuk olgahryniuk commented Feb 25, 2026

This PR updates the 'Strategy', 'FAQs', and 'Glossary' sections in line with Kris's suggestions. The goal is to ensure the copy is up to date and follows IO's style guidelines.

More sections, including use cases, cost estimates, and resources, are now reviewed and edited as well.

@olgahryniuk olgahryniuk changed the title Update Strategy Update documentation sections Feb 25, 2026
This PR updates the 'Strategy' section in line with Kris's suggestions. The goal is to ensure that the copy is up-to-date and follows IO's style guidelines.  More changes to be made within this PR.
This commit updates FAQs for relevance and the latest development progress. Based on suggestions from Kris.
Updating glossary entries in line with Kris's suggestions
- Add formal specs to resources since we'll remove them from the navigation
- Some formatting and editing
This commit updates the use cases section, improving grammar and making the language more appropriate for documentation.
- Improve grammar
- Make language more appropriate for documentation
Add the technical design document and fix a broken link
@olgahryniuk
Copy link
Contributor Author

Hi @ch1bo! This PR is ready for your review and merging.
Can you please also:

  • Remove the formal specifications tab from the navigation (those are now added to resources)
  • Remove the CIP and CPS links from the navigation (those are covered in resources)
  • Remove the 'Technical design' link from the 'Development' section (it's now added to resources)
  • Move the 'Visualizer' external link from the 'Development' section to its subsection > 'Research and development', potentially to be placed after 'Cost estimator'.

Thank you!

@olgahryniuk olgahryniuk marked this pull request as ready for review February 26, 2026 08:23
@ch1bo ch1bo self-requested a review February 26, 2026 19:08
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.

1 participant