Skip to content

[ doc ] Adding tutorials#288

Open
GulinSS wants to merge 3 commits intobuzden:masterfrom
GulinSS:master
Open

[ doc ] Adding tutorials#288
GulinSS wants to merge 3 commits intobuzden:masterfrom
GulinSS:master

Conversation

@GulinSS
Copy link
Copy Markdown
Contributor

@GulinSS GulinSS commented Oct 24, 2025

Here we are going to use https://openrouter.ai/ with https://github.com/charmbracelet/crush and https://github.com/The-Pocket/PocketFlow-Tutorial-Codebase-Knowledge (https://code2tutorial.com/) to improve our documentation by writing templated tutorials.

AI result is not a ready for use, so, manual tweaking is still needed howbeit removal operations I like more than putting something in when we are talking about text and code.

It is a watch-like PR which is not for merging, just for demo of working progress

@GulinSS GulinSS marked this pull request as draft October 24, 2025 05:31
@GulinSS
Copy link
Copy Markdown
Contributor Author

GulinSS commented Oct 24, 2025

image Do not 👀, by the end of work we will have only tutorials at the folder and nothing more. Everything other are temporal drafts.

@buzden buzden added code: enhancement New feature or improvement part: docs Related to documentation and readme labels Oct 24, 2025
@GulinSS GulinSS force-pushed the master branch 5 times, most recently from ef08aef to 264e428 Compare March 4, 2026 15:26
@GulinSS GulinSS force-pushed the master branch 2 times, most recently from 0f1b5c9 to e18995d Compare March 7, 2026 10:48
@GulinSS GulinSS marked this pull request as ready for review March 7, 2026 17:17
@GulinSS
Copy link
Copy Markdown
Contributor Author

GulinSS commented Mar 15, 2026

Ready to demo

@GulinSS
Copy link
Copy Markdown
Contributor Author

GulinSS commented Mar 16, 2026

The issue at CI has no relation to the subject of PR

 7/27: Building Tutorials.T04AutomaticGeneratorDerivation (src/Tutorials/T04AutomaticGeneratorDerivation.md)
Error: Failing block failed with the wrong error.
Expected "No constructors found for the type `^prim^.String`" but got:
While processing right hand side of genEntry. Error during reflection: While processing right hand side of {arg:13543},<Main.Entry>[]. While processing right hand side of {conArg:13578},<<Main.File>>. Undefined name <^prim^.String>[]. 

GulinSS added 2 commits March 19, 2026 11:57
Replace sed-based capitalization with perl for cross-platform compatibility.
BSD sed on macOS doesn't support `\u` escape sequences, causing the script to
produce literal 'u' prefixes instead of capitalized directory names.

Changes:
- Use perl for case conversion with sed fallback
- Replace echo -n with printf for POSIX shell compliance
- Use heredoc for docs.ipkg generation for reliable newline handling
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

code: enhancement New feature or improvement part: docs Related to documentation and readme

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants