4 ms·
Suggestion for this repo: prompts embedded in JSON files are quite hard to read, especially in mobile browsers. You could add some code (perhaps in a GitHub Ac
by simonw 2y ago
Suggestion for this repo: prompts embedded in JSON files are quite hard to read, especially in mobile browsers.
You could add some code (perhaps in a GitHub Action) that extracts the prompts out into accompanying Markdown files to fix this.
You’ve already done most of the work to create this file: https://github.com/Explosion-Scratch/apple-intelligence-prompts/blob/main/summary.json https://github.com/Explosion-Scratch/apple-intelligence-prom...
- jumploops 2y agoIs there an emerging best practice for complex prompt management? We use markdown and simple string replacement for most of our prompts, but it feels hacky and potentially error prone.
- rrandall 2y agoMarkdown w/ string replacement seems fine to me. JSON works well for when you need to structure the rest of the config along with the prompt. I assume you could combine markdown + JSON. You will start running into issues with referential integrity, etc. with just a plain text file though. You may also want outside collaborators other than devs. So you might need a more involved prompt management system on top of that. What feels error prone to you?
- jumploops 2y agoYes, we use JSON heavily as well. The string replacement feels error prone, and ideally we would have better methods for reviewing full prompts beyond running the code. I’m imagining something like Storybook[0] but for our prompt management. Something that renders the markdown and can do realtime replacement across the different paths we use for generating prompts. For context, we reuse many “wrapper” prompts and then have a few context-specific replacement prompts that are nested within the larger prompts. It works OK for one level of depth, but multiple levels make it hard to interpret from the raw code itself. During dev/runtime, we have some color coordination for the different levels, but again, ideally this was built into the way we store/version our prompts. We’ve looked into a few different prompt analytic/versioning tools, but they all seem too simple for our use-case. [0]https://storybook.js.org/ https://storybook.js.org/
- rrandall 2y agoHmm, mind if I shoot you an email? We might be able to help then.
- jumploops 2y agoSure! [username]@gmail.com
- Terretta 2y agoYour placeholder site describes a product that suits one of our use cases as well. Please launch with "Sign in with" for Microsoft as well as the typical GitHub / Google, allowing anyone using an M365 business to allow their employees to poor-man's SSO. See the "Continue with" section here, for instance: https://www.xsplit.com/user/auth https://www.xsplit.com/user/auth Or here: https://id.atlassian.com/login https://id.atlassian.com/login
- ilikepi 2y agoFWIW, viewing the "raw" version of a file is a little better since long lines will be wrapped.
- simonw 2y agoI built an Observable Notebook that pulls the JSON from GitHub and renders it as HTML: https://observablehq.com/@simonw/apple-intelligence-prompts https://observablehq.com/@simonw/apple-intelligence-prompts
- explosion-s 2y agoI'm honored to have the great SimonW comment (lol) I've just pushed an update that incorporates a lot of the rendering from your notebook into the main repo - Thanks for the suggestion!