Say which of the three sample catalogues answers which question - #151
Merged
Conversation
615 working apps live in three repositories, and until now the only way to find out which one to open was to know all three existed. The cookbook links individual samples per chapter (link-samples.mjs), which answers "show me one for THIS page" - not "where do I look". samples 152 has somebody already built this PATTERN samples-controls 431 how is this CONTROL expressed in ABAP samples-stack 32 how do I reach my SYSTEM from an app Picking the wrong one costs more time than reading the page, so the table says it in one line each, with the rule of thumb underneath: samples if you are learning, samples-controls if you already know the control, samples-stack only when the app has to talk to something in the system. The rest of the page is the part a reader cannot see from the catalogues themselves: that all three pages have the SAME row shape, that the title, the sentence and the search terms all live ON THE CLASS rather than on the page, and that each repository refuses a sample missing one of them - which is why a catalogue can never describe a sample differently from the class it links to. Plus the two lines an agent needs (`examples` searches all three at once, `capabilities` answers the neighbouring question) and how to start one in a system. The nav's Links block listed `samples` alone; it now names all three.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
615 working apps live in three repositories, and until now the only way to find out which one to open was to know all three existed. The cookbook links individual samples per chapter (
link-samples.mjs) — that answers "show me one for this page", not "where do I look".samplessamples-controlssamples-stackPicking the wrong one costs more time than reading the page, so the table says it in one line each, with the rule of thumb underneath:
samplesif you are learning,samples-controlsif you already know the control,samples-stackonly when the app has to talk to something in the system.The half a reader cannot see from the catalogues themselves
Ctrl+Fon those pages is a real searchPlus the two lines an agent needs (
examplessearches all three at once,capabilitiesanswers the neighbouring question) and how to start a sample in a system.The nav's Links block listed
samplesalone; it now names all three.docs:buildgreen,check:examplesgreen,npm testgreen, andgenerate-llmspicks the page up (it is inllms.txt, so it reaches agents too).Generated by Claude Code