-
Notifications
You must be signed in to change notification settings - Fork 649
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
dx barriers to entry tags api preview gripes suggestions #1858
Comments
Appreciate the callout. We'll look into smoothing those things out. PR's welcome of course 😄 |
Linking related PR marko-js/tags-api-preview#29 (for compile error in readme example) Linking related PR marko-js/cli#214 (updates |
@DylanPiercey looking like the primary issues with A) the readme example needing to be updated to be |
(wip) |
Thanks for your work and feedback here. |
--template
flag does not work.https://twitter.com/MarkoDevTeam/status/1420431542485012485
this command proposes a dialog to the user to select "Default starter app"
TODO: Twitter post should be ammended to read like that:
probably will need to see if fix can be made in https://github.com/marko-js/clialso notice suggesting a slight difference to command here:
https://github.com/marko-js/cli/tree/main/packages/create#npm
npm init @marko myapp --template webpack
notice the@marko
instead of justmarko
EDIT: proposed changes here marko-js/cli#214
Example code errors
so after
--template tags-api
fails causing regular marko5 app user may go ahead andnpm install @marko/tags-api-preview
then they may try copy/paste example from readme at https://github.com/marko-js/tags-api-preview#examplewhich will fail to compile at which point developer user might say screw itEDIT: proposed changes here marko-js/tags-api-preview#29
Consider specifying
@latest
:npm init marko@latest --template ...
just assuming that
@latest
could help if someone somehow has outdated markoNOTE: primarily a suggestion for the Twitter post and/or blog type posts
More examples
regarding: https://github.com/marko-js/tags-api-preview
TODO: mention using
npm init marko -- --template tags-api
command to create a new projectTODO: point to https://github.com/marko-js/examples/tree/master/examples/tags-api-guide as well
regarding: https://dev.to/ryansolid/introducing-the-marko-tags-api-preview-37o4
TODO: cannot copy/paste code examples as they are all images... perhaps at least provide try online links like for initial count example... could perhaps be added to examples repo as a set of examples similar to the tags-api-guide set of examples
TODO: mention using
npm init marko@latest -- --template tags-api
command to create a new projectThe text was updated successfully, but these errors were encountered: