This is the third draft, authored by @circlebuilder today and I'm opening this PR on his behalf.
See the preview at: https://forgejo.codeberg.page/@wip-blog/news/2022-12-08-hello-forgejo/
Refs: forgejo/meta#8
d5cc33f169
a4e7942a05
a4e7942a05
64bd26b621
@ -0,0 +18,4 @@
The first objective relates to how we are organized as a project. It is crucial for Forgejo to guarantee that our product will remain Free Software forever, under the guidance of an open and inclusive community. Forgejo will provide a healthy project governance, so that it can truly focus on the needs of all those people that use our software on a daily basis.
To this end we are very proud that Codeberg.org has decided to become our project’s custodian. Codeberg e.V. is a non-profit organization with a stellar reputation, that is dedicated to the success of the Free Software movement. Providing software development services to FOSS projects, Codeberg is rapidly growing. Currently Codeberg is hosting more than 50k code repositories for about 40k people. Not only will Codeberg take care of the Forgejo domain names and trademarks, but the organization will use Forgejo as the basis for their own services, instead of Gitea.
50k is an abbreviation not all people (esp. non-tech people) might understand.
I think most people would understand, but since this is prose, not technical writing, I agree that it would read better to write 50 thousand and 40 thousand respectively.
[edit: or just 50,000 and 40,000 of course]
@ -0,0 +24,4 @@
### We will help liberate software development
Our second objective relates to the product that we deliver. Free Software projects are in general heavily focused on coding. But development of quality software has many other areas that need due attention. For the long-term sustainability of any Free Software project many aspects must be taken into account. Successful software products involve the collaboration between many people with different skill sets.
due attention?
I looked it up. It's valid English, but I'm not sure, whether it carries the connotation we want to transport. It's more like those areas were neglected by code forges so far.
It reads fine to me as a native speaker, but you could also just say attention or perhaps better, rephrase to something like ...development of quality software also involves work in many other areas.
In the last sentence, s/involve the collaboration/involve collaboration/ (the the is redundant).
Free Software project, many aspects (comma)
@ -0,0 +32,4 @@
### Join our adventure
Help make coding social. Join us in our quest, be part of our adventure. Forgejo is not just a code forge. We go beyond coding. We forge Free Software!
Last bit should be "Together we forge Free Software!" and it might be in bold text.
Bold text translates to strong emphasis in Markdown, i.e. the latter has semantics.
I think strong emphasis is what @circlebuilder intends. (In fact, the HTML5 spec currently defines it as "strong importance, seriousness, or urgency", but it comes to the same.)
Yes, indeed :)
This is a fantastic introductory post, good job @circlebuilder.
Here are a few minor tweaks I'd make:
@ -0,0 +7,4 @@
After many days of hard work and preparation by a team of former Gitea maintainers and enthusiasts from the FOSS community we are proud to announce that the Forgejo project is now live.
Forgejo (inspired by forĝejo /ˈfor.d͡ʒe.jo/ – the Esperanto word for forge) is a community-driven Free Software project that develops a code forge platform similar to Github, and that is a drop-in replacement of Gitea. We started Forgejo in reaction to Gitea Ltd taking over from the community as a for-profit company without consulting the community, and after an [Open Letter](https://gitea-open-letter.coding.social/) to the Gitea project owners remained unanswered.
- Forgejo (inspired by forĝejo /ˈfor.d͡ʒe.jo/ – the Esperanto word for forge)
+ Forgejo (/forˈd͡ʒe.jo/ – inspired by *forĝejo*, the Esperanto word for forge)
inspired by a link to forgejo/meta#50 s/replacement of Gitea/replacement for Gitea/- We started Forgejo in reaction to Gitea Ltd taking over from the community as a for-profit company without consulting the community
+ We started Forgejo in reaction to control of Gitea being taken away from the community by the newly-formed for-profit company Gitea Ltd without prior community consultation
I would - as a rule - minimize the number of hyperlinks in blog posts, to only include those that are really most essential. Any hyperlink can cause TL;DR'ing folks to not read to the end of the post.
Good point, agreed.
If we want to avoid more discussions about whether this the name is valid Esperanto, despite the "inspired by" phraseology, we could make inspired by a link to forgejo/meta#50
Not acted upon to avoid adding too many links.
@ -0,0 +12,4 @@
The Forgejo project has two major objectives that drive our development and road map:
1. The community is in control, and ensures we develop to address community needs.
2. We will help liberate software development from the shackles of proprietary tools.
Should these be links to the two relevant sections below?
I think it is implied. No need to link. In the text I also mention "first" and "second" objective at the start of these sections.
@ -0,0 +20,4 @@
To this end we are very proud that Codeberg.org has decided to become our project’s custodian. Codeberg e.V. is a non-profit organization with a stellar reputation, that is dedicated to the success of the Free Software movement. Providing software development services to FOSS projects, Codeberg is rapidly growing. Currently Codeberg is hosting more than 50k code repositories for about 40k people. Not only will Codeberg take care of the Forgejo domain names and trademarks, but the organization will use Forgejo as the basis for their own services, instead of Gitea.
Forgejo's code base is of course hosted on Codeberg, and by using Woodpecker CI instead of Drone and Matrix instead of Discord, we exclusively rely on Free Software tools.
I'm not sure that the Codeberg.org / Codeberg e.V. distinction is correct above.
Codeberg.org is the website. Codeberg e.V. is the organization which "has decided to become our project’s custodian".
This could also be a link to Codeberg's homepage.
See earlier comment on minimizing links. I'd only have one single link to Codeberg. May be first occurrence is best for that.
Sure, it could just be the first occurrence.
Either way, it should say that Codeberg e.V. has decided to become our project’s custodian (instead of the current Codeberg.org has decided to become our project’s custodian).
To this end we are very proud that Codeberg e.V. has decided to become our project’s custodian. Codeberg e.V. is a non-profit organization with a stellar reputation, that is dedicated to the success of the Free Software movement. They provide software development services to FOSS projects at Codeberg.org. They are rapidly growing and hosting more than 50k code repositories for about 40k people.
My proposal here, bold means changed.
@ -0,0 +26,4 @@
Our second objective relates to the product that we deliver. Free Software projects are in general heavily focused on coding. But development of quality software has many other areas that need due attention. For the long-term sustainability of any Free Software project many aspects must be taken into account. Successful software products involve the collaboration between many people with different skill sets.
Forgejo has a vision to make software development accessible to everyone. Bring true inclusion and diversity to a field traditionally dominated by technical-skilled people, and where many of the tools used are proprietary services with companies dictating who has access, and who does not.
- Forgejo has a vision to make software development accessible to everyone. Bring true inclusion
+ Forgejo's vision is to make software development accessible to everyone – bringing true inclusion
@ -0,0 +5,4 @@
tags: ['blog']
---
After many days of hard work and preparation by a team of former Gitea maintainers and enthusiasts from the FOSS community we are proud to announce that the Forgejo project is now live.
... FOSS community, we are proud ... (comma)
I applied all suggestions the best I could, separating them in different commits to help in case I did something wrong.
If there is no objection by tomorrow this will be merged as is.
@ -0,0 +15,4 @@
### We are people in control of our future
The first objective relates to how we are organized as a project. It is crucial for Forgejo to guarantee that our product will remain Free Software forever, under the guidance of an open and inclusive community. Forgejo will provide a healthy project governance, so that it can truly focus on the needs of all those people that use our software on a daily basis.
focus on the needs of all those people that use our software on a daily basis
shouldn't this be:
focus on the needs of all people that use our software on a daily basis
disclaimer: I'm not a native English speaker and entirely unsure this should be changed 😊
To me it's fine either way. As a native speaker I prefer the former slightly, but if the latter is clearer to you it would also work.
Thank you for the work on this @dachary 👍
No due date set.
No dependencies set.
Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?