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

Point other documentation to the slint language reference #2173

Merged
merged 3 commits into from Feb 7, 2023

Conversation

hunger
Copy link
Member

@hunger hunger commented Feb 1, 2023

Note: Before this can be merged we need to bump the version number and add a redirect to our website!

The slint crate documentation creates a full link to the web site, so that it does not break on docs.rs. That link contains the crate version (currently 0.3.4), so it does not work right now as the 0.3.4 release does not come with the slint mdbook.

C++ uses relative links and is fine.

NodeJS picked the README.md, which is also used on github. I deduplicated that use by copying the README.md to cover.md, adding a relative link to the slint manual there.

@@ -37,10 +37,6 @@ Welcome to Slint C++'s documentation!

genindex

language.rst

markdown/debugging_techniques.md
Copy link
Member

Choose a reason for hiding this comment

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

Why did you remove the debugging techniques file?

Copy link
Member Author

Choose a reason for hiding this comment

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

I moved it into the language reference.

Add a simple index.html to the docs area and link to the supported
languages from there.
For node and cpp, I use relative links to point to the slint language
reference documentation.

For the slint crate documentation I create a link to
https://slint-ui.com/releases/VERSION/... instead: This needs to work from
docs.rs as well as from our own docs area on slint-ui.com! That is
pretty ugly: I can not even define constants for this as the crate docs
need to come before anything else.
@hunger
Copy link
Member Author

hunger commented Feb 2, 2023

The Debugging section is back where it came from, the index page also links to the tutorials.

I'd like to merge this next week (if nothing comes up) to test it live.

@tronical
Copy link
Member

tronical commented Feb 2, 2023

Looking forward to trying this, too :)

@hunger hunger merged commit 1370bd7 into slint-ui:master Feb 7, 2023
@hunger hunger deleted the langref_dedup branch February 7, 2023 11:10
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.

None yet

2 participants