Organization.md has room for improvement #22393

Open
opened 2026-01-31 08:11:56 +00:00 by claunia · 3 comments
Owner

Originally created by @Haaziq386 on GitHub (Oct 13, 2024).

The terminal/doc/ORGANIZATION.md
file doesn't speak about folders like .config .github etc which may be necessary for someone who is new to this repository.
Also it is a bit outdated like it talks about /src/host/tools but it doesn't exist currently.

Thus it can be worked upon and can be improved

Originally created by @Haaziq386 on GitHub (Oct 13, 2024). <!-- Briefly describe which document needs to be corrected and why. --> The [terminal](https://github.com/microsoft/terminal/tree/main)/[doc](https://github.com/microsoft/terminal/tree/main/doc)/ORGANIZATION.md file doesn't speak about folders like .config .github etc which may be necessary for someone who is new to this repository. Also it is a bit outdated like it talks about /src/host/tools but it doesn't exist currently. Thus it can be worked upon and can be improved
claunia added the Help WantedNeeds-Tag-FixIssue-DocsProduct-Meta labels 2026-01-31 08:11:56 +00:00
Author
Owner

@Haaziq386 commented on GitHub (Oct 13, 2024):

Can i work on this issue i.e improve the ORGANIZATION.md file?(i am new to this repo)

@Haaziq386 commented on GitHub (Oct 13, 2024): Can i work on this issue i.e improve the ORGANIZATION.md file?(i am new to this repo)
Author
Owner

@carlos-zamora commented on GitHub (Oct 16, 2024):

Thanks for filing! Yeah, we should update this. We should link it in the main README too, since this'll be helpful for people new to the repo.

You're welcome to work on this issue, just please don't use an LLM to rewrite it for us.

@carlos-zamora commented on GitHub (Oct 16, 2024): Thanks for filing! Yeah, we should update this. We should link it in the main README too, since this'll be helpful for people new to the repo. You're welcome to work on this issue, just please don't use an LLM to rewrite it for us.
Author
Owner

@MikhagnusTalsen commented on GitHub (Jun 8, 2025):

@carlos-zamora
Hi, I'm new here. I see folders not mentioned in the doc, can I try updating it ?
The file is for new comers like me so I'm not sure I should be the one doing it as my "good-first-issue".

@MikhagnusTalsen commented on GitHub (Jun 8, 2025): @carlos-zamora Hi, I'm new here. I see folders not mentioned in the doc, can I try updating it ? The file is for new comers like me so I'm not sure I should be the one doing it as my "good-first-issue".
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: starred/terminal#22393