Skip to content

Conversation

@dodo920306
Copy link
Contributor

@dodo920306 dodo920306 commented Jun 29, 2025

Currently, there is not that much information users can get from the concept page, and the expressions are really confusing.

Additionally, some parts seem obsolete.

Thus, this PR rewrites the page for better clarification.

Signed-off-by: dodo920306 <[email protected]>
@dodo920306 dodo920306 marked this pull request as draft June 29, 2025 16:35
@dodo920306 dodo920306 changed the title Refactor concept explainations Rewrite concept explainations Jul 1, 2025
yeasy and others added 4 commits July 4, 2025 18:10
Some syntax can't be parsed by the original settings. Fix missing `pymdownx.mark`
and `pymdownx.critic` and wrong theme name.

Signed-off-by: dodo920306 <[email protected]>
@dodo920306 dodo920306 marked this pull request as ready for review July 8, 2025 02:27
@dodo920306
Copy link
Contributor Author

May I ask how can we update the online document? Also, why are there 2 different versions of them?
https://hyperledger-cello.readthedocs.io/en/latest/
https://cello.readthedocs.io/en/latest/
(Check out the setup page and you can see the difference.)

@yeasy
Copy link
Contributor

yeasy commented Jul 8, 2025

https://cello.readthedocs.io/en/latest/

This one needs a fix at #712.

@dodo920306
Copy link
Contributor Author

dodo920306 commented Jul 9, 2025

https://cello.readthedocs.io/en/latest/

This one needs a fix at #712.

How about the other one? Can we shut it down?

@yeasy
Copy link
Contributor

yeasy commented Jul 9, 2025

https://cello.readthedocs.io/en/latest/

This one needs a fix at #712.

How about another one? Can we shut it down?

I do not know who is handling the other one. Possibly the LF team. @ryjones

@ryjones
Copy link
Contributor

ryjones commented Jul 9, 2025

OK I merged it

@dodo920306
Copy link
Contributor Author

dodo920306 commented Jul 10, 2025

@ryjones Can you help redirecting or shutting down https://hyperledger-cello.readthedocs.io? It appears on top of Google search results with an older version of the docs. It can be misleading people.

@yeasy
Copy link
Contributor

yeasy commented Jul 10, 2025

@ryjones Can you help redirecting or shutting down https://hyperledger-cello.readthedocs.io? It appears on top of Google search results with an older version of the docs. It can be misleading people.

I think @ryjones needs to config the site to trigger building automatically with the new code commit?

@yeasy yeasy merged commit 439ff92 into hyperledger-cello:main Jul 10, 2025
3 checks passed
@dodo920306
Copy link
Contributor Author

@ryjones Can you help redirecting or shutting down https://hyperledger-cello.readthedocs.io? It appears on top of Google search results with an older version of the docs. It can be misleading people.

I think @ryjones needs to config the site to trigger building automatically with the new code commit?

Yeah. But still, there's no need to keep 2 docs sites.

@ryjones
Copy link
Contributor

ryjones commented Jul 10, 2025

@ryjones
Copy link
Contributor

ryjones commented Jul 12, 2025

@dodo920306 - @yeasy and @hightall control those two sites. Once I have the power to admin them, I'll fix it up

@yeasy
Copy link
Contributor

yeasy commented Jul 16, 2025

@dodo920306 - @yeasy and @hightall control those two sites. Once I have the power to admin them, I'll fix it up

Triggered the rebuilding.

@ryjones
Copy link
Contributor

ryjones commented Jul 16, 2025

@yeasy please add me as an owner to both projects on rtd

@yeasy
Copy link
Contributor

yeasy commented Jul 16, 2025

We will use https://app.readthedocs.org/projects/hyperledger-cello/, and add you both as maintainer. @dodo920306 @ryjones

@dodo920306 dodo920306 deleted the fix/refactor-concepts branch July 17, 2025 01:24
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.

3 participants