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

Polish packages and documentation for a major release #64

Merged
merged 8 commits into from
Mar 26, 2025

Conversation

jwloka
Copy link
Member

@jwloka jwloka commented Mar 25, 2025

This pull request includes several documentation updates to improve clarity and consistency across the websmith project. The most important changes include updates to the README.md files for various packages, adjustments to the websmith command options, and refinements to the addon implementation guidelines.

Documentation updates:

  • README.md: Updated descriptions to emphasize customization of the compilation output rather than the process. This includes changing phrases like "compilation process" to "compilation output" and updating links to the relevant sections. [1] [2] [3] [4] [5] [6]
  • packages/api/README.md: Renamed the package to @quatico/websmith-api and added detailed descriptions of the addon capabilities and usage examples.
  • packages/api/docs/write-your-own-addon.md: Updated the addon API description to focus on customizing the compilation output and provided clearer instructions for implementing and integrating addons. [1] [2]
  • packages/compiler/README.md: Revised the introduction to highlight the websmith command as a drop-in replacement for tsc with additional customization options. Added sections on using compiler addons, command line parameters, and defining and activating compilation profiles.
  • packages/core/README.md: Clarified that this package contains shared library functions and is a peer dependency of the @quatico/websmith-compiler package.

Command options adjustments:

  • packages/compiler/src/command.ts: Updated the descriptions of the --addons and --transpileOnly options to reflect that no addons are applied by default, and added a period at the end of the --project option's description for consistency.

jwloka added 6 commits March 25, 2025 06:31
Introducing Profiles: Replace compilation targets with profiles #55
… and CLI parameters

Introducing Profiles: Replace compilation targets with profiles #55
Introducing Profiles: Replace compilation targets with profiles #55
Introducing Profiles: Replace compilation targets with profiles #55
… to use its API

Introducing Profiles: Replace compilation targets with profiles #55
…README file

Introducing Profiles: Replace compilation targets with profiles #55
@jwloka jwloka added the documentation Improvements or additions to documentation label Mar 25, 2025
@jwloka jwloka added this to the 55 milestone Mar 25, 2025
@jwloka jwloka requested a review from meck93 March 25, 2025 05:37
jwloka added 2 commits March 26, 2025 05:36
Introducing Profiles: Replace compilation targets with profiles #55
…s linked sections

Introducing Profiles: Replace compilation targets with profiles #55
Copy link
Member

@meck93 meck93 left a comment

Choose a reason for hiding this comment

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

Sieht grundsätzlich i.o. aus. Habe es nur überflogen.

Ich würde es gerne im Detail lesen, wenn es released ist und ich es direkt anwenden kann. Bzw. der Doku folgen kann und versuchen die Schritte gemäss Doku 1:1 direkt selbst anzuwenden. Ok?

Falls es Dokumentationsänderungen gibt können wir ja einen Patch Release machen.

@jwloka jwloka merged commit c265bc8 into develop Mar 26, 2025
2 checks passed
@jwloka jwloka deleted the polish-packages-and-documentation branch March 26, 2025 12:00
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants