Skip to content

refactor: docs path updates#17459

Merged
tac0turtle merged 31 commits into
mainfrom
sam/change-paths-docs
Sep 5, 2023
Merged

refactor: docs path updates#17459
tac0turtle merged 31 commits into
mainfrom
sam/change-paths-docs

Conversation

@samricotta

@samricotta samricotta commented Aug 19, 2023

Copy link
Copy Markdown
Contributor

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)

Comment thread docs/docusaurus.config.js Outdated

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.

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

@julienrbrt

Copy link
Copy Markdown
Contributor

We should pause the deployment for a few days and do the migration to the new one. This way it's less confusing and we can break things with out worrying

👍🏾

Then can we have a PR disabling the deploy github action?

@tac0turtle

Copy link
Copy Markdown
Contributor

We should pause the deployment for a few days and do the migration to the new one. This way it's less confusing and we can break things with out worrying

👍🏾

Then can we have a PR disabling the deploy github action?

lets do it in this pr

@tac0turtle

Copy link
Copy Markdown
Contributor

@tac0turtle I think basics for ppl who are ESL makes sense but I think if we are going down that route, core doesnt necessarily work imo

core and basics can be the same thing. or we can do beginner, intermediate and advanced

Comment thread docs/docs/develop/beginner/01-tx-lifecycle.md Outdated
Comment thread docs/docs/develop/beginner/01-tx-lifecycle.md Outdated

@julienrbrt julienrbrt left a comment

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.

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

Comment thread 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
Copy Markdown
Contributor

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.

Comment thread docs/pre.sh Outdated
MODDOC=docs/build/modules/$(basename "$D")
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
Copy Markdown
Contributor

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.

@samricotta samricotta Sep 1, 2023

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.

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
Copy Markdown
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
Copy Markdown
Contributor

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
Copy Markdown
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
Copy Markdown
Contributor

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
Copy Markdown
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
Copy Markdown
Contributor

@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.

@tac0turtle tac0turtle left a comment

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.

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

@tac0turtle

Copy link
Copy Markdown
Contributor

@Mergifyio backport release/v0.50

@mergify

mergify Bot commented Sep 5, 2023

Copy link
Copy Markdown
Contributor

backport release/v0.50

❌ No backport have been created

Details
  • Backport to branch release/v0.50 failed

GitHub error: Branch not found

@tac0turtle

Copy link
Copy Markdown
Contributor

@Mergifyio backport release/v0.50.x

@mergify

mergify Bot commented Sep 5, 2023

Copy link
Copy Markdown
Contributor

backport release/v0.50.x

✅ Backports have been created

Details

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

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