Skip to content

docs: add missing README files to element-ng, element-theme, and element-translate-cli#1645

Open
vineethwilson15 wants to merge 2 commits intosiemens:mainfrom
vineethwilson15:docs/add-package-readmes
Open

docs: add missing README files to element-ng, element-theme, and element-translate-cli#1645
vineethwilson15 wants to merge 2 commits intosiemens:mainfrom
vineethwilson15:docs/add-package-readmes

Conversation

@vineethwilson15
Copy link

Adds missing README.md files to three npm-published packages that currently show
no documentation on the npm registry:

  • @siemens/element-ng — core component library
  • @siemens/element-theme — SCSS theme package
  • @siemens/element-translate-cli — translation CLI tool

Content and style are aligned with existing package READMEs (charts-ng, maps-ng,
native-charts-ng). Each README covers installation, peer dependencies, basic usage,
and licensing.

Closes #1050

…ent-translate-cli

All three npm-published packages were missing README.md files,
leaving their npm registry pages without documentation. Content
and style aligned with existing package READMEs (charts-ng, maps-ng).

Closes siemens#1050
@vineethwilson15 vineethwilson15 requested review from a team as code owners March 14, 2026 13:34
@CLAassistant
Copy link

CLA assistant check
Thank you for your submission! We really appreciate it. Like many open source projects, we ask that you sign our Contributor License Agreement before we can accept your contribution.


Vineeth Wilson seems not to be a GitHub user. You need a GitHub account to be able to sign the CLA. If you have already a GitHub account, please add the email address used for this commit to your account.
You have signed the CLA already but the status is still pending? Let us recheck it.

Copy link
Contributor

@gemini-code-assist gemini-code-assist bot left a comment

Choose a reason for hiding this comment

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

Code Review

This pull request adds missing README.md files to three packages, which is a great improvement for discoverability on npm. The new documentation is well-structured and provides the necessary information for users to get started. I've made a few suggestions to align the content more closely with the project's UX writing style guide and to improve consistency across the new files. These changes mainly involve wording, capitalization, and adding a missing license link.

- Combine peer dependency install commands into one line
- Use sentence case for section headings
- Prefer 'run' over 'execute'/'executing' per UX writing guidelines
- Add MIT license link to element-ng README
@spike-rabbit
Copy link
Member

@timowolf what is your opinions about README.md in those packages?
For element-ng we currently use the root README.md in some other packages, this is indeed missing.

I would be in favor of going the Angular way and just include a very simple README.md linking to this repository and element.siemens.io. So just copying our root README.md everywhere would be fine.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add and align package README.md to all packages

3 participants