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

Update of README.md structure in all sub projects #124

Open
27 tasks
hdamker opened this issue Apr 15, 2024 · 3 comments
Open
27 tasks

Update of README.md structure in all sub projects #124

hdamker opened this issue Apr 15, 2024 · 3 comments
Assignees
Labels
project management Work to be done for the project

Comments

@hdamker
Copy link
Collaborator

hdamker commented Apr 15, 2024

To improve the structure to project and working group information, and to make the information within the README.md files consistent and reusable within the wiki and website, there is currently an update of the README.md within the repo template proposed by the LF team: camaraproject/Template_Lead_Repository#3

As soon as this PR is merged into the repo template we also have to make sure that all existing repos (README files) are updated to the same structure (and also all the website pages). The new README.md files will also be used as the base information within the sub project wiki pages (see here for an example).

Update: Checklist of all repositories, to track the progress of this issue (can btw be copied also into other similar issues):

Working Groups

(API) Sub Projects

@hdamker
Copy link
Collaborator Author

hdamker commented May 2, 2024

@wrathwolf Could you check of above the ones which are already done and support the remaining ones to get there?

For each Sub Project:

  • README.md adapted to the new template
  • README.md used within Sub Project wiki page (with Macro)
  • Page of the Sub Project update within the web site (hopefully also with a macro or similar)

@AxelNennker
Copy link

My comment on the PR was in the wrong place, sorry for that.
Maybe the comment is more fitting here:

I think the scope section in the template is not fitting any working group.

´´´
Service APIs for “§repo_name§” (see APIBacklog.md)
It provides the customer with the ability to:

§API (family) description§.

:

NOTE: The scope of this API family should be limited (at least at the first stage) to 4G and 5G.

Describe, develop, document, and test the APIs
´´´

I can't think of a template-text for "Scope" that fits all working groups.

Can we have a template like this?:


§repo_name§

Repository to describe, develop, document, and test the §repo_name§ API family

  • Started: §start date§

Scope

§scope§


start_date is moved up.
The content of §scope§ is defined somewhere else?

I do not know enough about the template process to make suggestions that are reasonable.
Or we fill-in the "scope" for working groups manually.

@hdamker
Copy link
Collaborator Author

hdamker commented May 14, 2024

@AxelNennker I created an issue within the Template Repository for that. It's only since we moved the working groups out of "WorkingsGroups" repo that the template is also used for working groups. Solution will be to mark clearly that the scope section has to be adapted within the Sub Project. The §scope§ is coming from the agreement within APIBacklog.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
project management Work to be done for the project
Projects
None yet
Development

No branches or pull requests

3 participants