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

refactor: docs path updates #17459

Merged
merged 31 commits into from
Sep 5, 2023
Merged

refactor: docs path updates #17459

merged 31 commits into from
Sep 5, 2023

Conversation

samricotta
Copy link
Contributor

@samricotta samricotta commented Aug 19, 2023

Description

Closes: #17458
Closes: #17380


Author Checklist

All items are required. Please add a note to the item if the item is not applicable and
please add links to any relevant follow up issues.

I have...

  • included the correct type prefix in the PR title
  • added ! to the type prefix if API or client breaking change
  • targeted the correct branch (see PR Targeting)
  • provided a link to the relevant issue or specification
  • followed the guidelines for building modules
  • included the necessary unit and integration tests
  • added a changelog entry to CHANGELOG.md
  • included comments for documenting Go code
  • updated the relevant documentation or specification
  • reviewed "Files changed" and left comments if necessary
  • run make lint and make test
  • confirmed all CI checks have passed

Reviewers Checklist

All items are required. Please add a note if the item is not applicable and please add
your handle next to the items reviewed if you only reviewed selected items.

I have...

  • confirmed the correct type prefix in the PR title
  • confirmed ! in the type prefix if API or client breaking change
  • confirmed all author checklist items have been addressed
  • reviewed state machine logic
  • reviewed API design and naming
  • reviewed documentation is accurate
  • reviewed tests and test coverage
  • manually tested (if applicable)

@samricotta samricotta added the T:Docs Changes and features related to documentation. label Aug 19, 2023
existingPath.replace('/run-node', '/user/run-node'),
existingPath.replace('/validate', '/user/validate')
];
},
Copy link
Contributor Author

Choose a reason for hiding this comment

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

added this in here so its uniform with the docs docusaurus.js, should be able to be deleted later

@tac0turtle tac0turtle removed the S: DO NOT MERGE Status: DO NOT MERGE label Sep 1, 2023
Copy link
Member

@julienrbrt julienrbrt left a comment

Choose a reason for hiding this comment

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

image

Some links are still broken. I still do not understand the README renaming changes, given that docusaurus know how to display this properly: https://docusaurus.io/docs/next/sidebar/autogenerated#category-index-convention

docs/pre.sh Outdated

## Add modules page list
cat ../x/README.md | sed 's/\.\.\/docs\/building-modules\/README\.md/\/building-modules\/intro\.html/g' > ./docs/modules/README.md
cat ../x/README.md | sed 's/\.\.\/docs\/build\/building-modules\/README\.md/\/building-modules\/intro\.html/g' > ./docs/build/modules/"$MODDOC/$(basename "$D").md"
Copy link
Member

Choose a reason for hiding this comment

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

This should still be ./docs/modules/README.md instead of this for this line, as mentioned above.

docs/pre.sh Outdated
rm -rf $MODDOC
mkdir -p $MODDOC && cp -r $D/README.md "$_"
mkdir -p $MODDOC && cp -r $D/README.md "$MODDOC/$(basename "$D").md"
Copy link
Member

Choose a reason for hiding this comment

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

I still do not understand why they cannot stay as README.md.
Docusaurus will render those properly and this avoids the link breakage you have in modules docs.

Copy link
Contributor Author

@samricotta samricotta Sep 1, 2023

Choose a reason for hiding this comment

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

Hmm, okay. The reason I added this in was bc it was reading as README.md when i built. But trust you and ill remove those then

@samricotta
Copy link
Contributor Author

@julienrbrt suggestions on this last link

Screenshot 2023-09-01 at 16 21 24 Screenshot 2023-09-01 at 16 21 01

Copy link
Member

Choose a reason for hiding this comment

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

Why is it deleted?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Duplicated - is already in build

Copy link
Member

Choose a reason for hiding this comment

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

Why is it deleted?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Duplicated - is already in build

@julienrbrt
Copy link
Member

@julienrbrt suggestions on this last link

Screenshot 2023-09-01 at 16 21 24 Screenshot 2023-09-01 at 16 21 01

This link is fine as it is an example, that is even commented, so it won't render.

Copy link
Member

@tac0turtle tac0turtle left a comment

Choose a reason for hiding this comment

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

id say lets merge it then test it on the other repo and see how it works. everything looks good now

@julienrbrt julienrbrt dismissed their stale review September 4, 2023 20:46

let's see then.

@tac0turtle tac0turtle added this pull request to the merge queue Sep 5, 2023
Merged via the queue into main with commit f198ea9 Sep 5, 2023
42 checks passed
@tac0turtle tac0turtle deleted the sam/change-paths-docs branch September 5, 2023 08:08
@tac0turtle
Copy link
Member

@Mergifyio backport release/v0.50

@mergify
Copy link
Contributor

mergify bot commented Sep 5, 2023

backport release/v0.50

❌ No backport have been created

  • Backport to branch release/v0.50 failed

GitHub error: Branch not found

@tac0turtle
Copy link
Member

@Mergifyio backport release/v0.50.x

@mergify
Copy link
Contributor

mergify bot commented Sep 5, 2023

backport release/v0.50.x

✅ Backports have been created

mergify bot pushed a commit that referenced this pull request Sep 5, 2023
Co-authored-by: Julien Robert <julien@rbrt.fr>
Co-authored-by: Marko <marko@baricevic.me>
Co-authored-by: marbar3778 <marbar3778@yahoo.com>
(cherry picked from commit f198ea9)

# Conflicts:
#	.github/workflows/deploy-docs.yml
#	UPGRADING.md
#	docs/docs/build/building-modules/01-module-manager.md
#	docs/docs/build/building-modules/06-keeper.md
#	docs/docs/develop/advanced/00-baseapp.md
#	docs/rfc/README.md
samricotta added a commit that referenced this pull request Sep 5, 2023
Co-authored-by: Julien Robert <julien@rbrt.fr>
Co-authored-by: Marko <marko@baricevic.me>
Co-authored-by: marbar3778 <marbar3778@yahoo.com>
(cherry picked from commit f198ea9)

# Conflicts:
#	.github/workflows/deploy-docs.yml
#	UPGRADING.md
#	docs/docs/build/building-modules/01-module-manager.md
#	docs/docs/build/building-modules/06-keeper.md
#	docs/docs/develop/advanced/00-baseapp.md
#	docs/rfc/README.md
tac0turtle added a commit that referenced this pull request Sep 5, 2023
Co-authored-by: samricotta <37125168+samricotta@users.noreply.github.com>
Co-authored-by: mergify[bot] <37929162+mergify[bot]@users.noreply.github.com>
Co-authored-by: Marko <marbar3778@yahoo.com>
Co-authored-by: samricotta <samanthalricotta@gmail.com>
@coderabbitai coderabbitai bot mentioned this pull request Apr 22, 2024
12 tasks
@faddat faddat mentioned this pull request Nov 8, 2024
12 tasks
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
T:Docs Changes and features related to documentation. Type: ADR Type: CI
Projects
None yet
Development

Successfully merging this pull request may close these issues.

[docs] Change the paths for docs in main sdk repo to reflect the docs repo [docs] Change integrate to Build
3 participants