docs(howto): Homogenize HowTo's format across translated files (#6724)
* Homogenize HowTo's
- Add H1 header
- `Read this` ... right alignmements
- Split a bit first paragraph to highlight welcome.
- Introduce Pull Request acronym.
- trademarks / typos: GitHub, YouTube, Pull Request
- Update GitHub links urls. `help`/`guides` subdomain was moved to `docs` so now a 301 Redirect is skipped.
- Details block added, with center align. When clicked, the contributor graphs is toggled.
- Some bolds to highlight common resources formating issues (like in CONTRIBUTING)
- Repo name in monospace font
- Re-worded last part of 4th paragraph to explain that no new PR is needed to open if there are linter errors or changes are requested. Now it's more clear, I thought.
Via EbookFoundation/free-programming-books#6590
* Rewording to be more meaningful
* Add H1 header + `Read this` ... aligned to right
Via EbookFoundation/free-programming-books#6590
* remove trailing spaces
* Split a bit first paragraph to highlight welcome.
Via EbookFoundation/free-programming-books#6590
* homogenize `1-2` newlines amount between paragraphs
* Update Github documentation links list
- Update GitHub links urls. `help`/`guides` subdomain was moved to `docs` so now a 301 Redirect is skipped.
- Remove flag emojis from link, perhaps use text in notes format to give accesibility locale context
Via EbookFoundation/free-programming-books#6590
* GitHub trademark typos
* YouTube trademark typos
* `Welcome to fpb!` in bold style
* Repo name backticked in monospace font
(non-translatable)
* reword es-en graph summary
* Add a centered details block with graphs about contributions (users vs. time)
Detail blocks are toggleable sections in GitHub
Provided graphs by apiseven:
- Contributor over time Graph
- Monthly Active Contributors graph
* GitHub trademark typos
* Fix pull request typos and introduce it acronym
* Update Github documentation links list
- Update GitHub links urls. `help`/`guides` subdomain was moved to `docs` so now a 301 Redirect is skipped.
- Remove flag emojis from link, perhaps use text in notes format to give accesibility locale context
The forgot rest addressed on 7ee485bb3b commit
Via EbookFoundation/free-programming-books#6590
* Some bolds to highlight common resources formating issues (like in CONTRIBUTING)
* Fix typos suggested by AhmedElTabarani
Co-authored-by: أحمد الطبراني <eltabaraniahmed@gmail.com>
* Add paragrah from #5351. Need language translation
* New strings translated to `it` Italian
Co-authored-by: ImVector <59611597+LuigiImVector@users.noreply.github.com>
* use languages not countries. `in Egyptian Arabic`
* use languages not countries. `in Algerian Arabic`
* remove notes from details block containing graphs about contributions (users vs. time)
* Fix spanish typos
Co-authored-by: Wonjang Son <sondaniel.88@gmail.com>
* Fix korean typos
Co-authored-by: Wonjang Son <sondaniel.88@gmail.com>
* New strings translated to `ar` Arabic
Co-authored-by: أحمد الطبراني <eltabaraniahmed@gmail.com>
* New strings translated to `fr` French
Co-authored-by: Loic Beylot <loic.beylot@gmail.com>
Co-authored-by: أحمد الطبراني <eltabaraniahmed@gmail.com>
Co-authored-by: ImVector <59611597+LuigiImVector@users.noreply.github.com>
Co-authored-by: Wonjang Son <sondaniel.88@gmail.com>
Co-authored-by: Loic Beylot <loic.beylot@gmail.com>
This commit is contained in:
David Ordás
GitHub
@ -1,16 +1,34 @@
|
||||
# How-To at a glance
|
||||
|
||||
<div align="right" markdown="1">
|
||||
|
||||
*[Прочитати іншими мовами](README.md#translations)*
|
||||
|
||||
Ласкаво просимо до Free-Programming-Books! Вітаємо нових учасників, навіть тих, хто робить свій перший pull request на Github. Якщо Ви один із них, ці ресурси можуть Вам допомогти:
|
||||
</div>
|
||||
|
||||
* [:us: Про Pull Requests](https://help.github.com/articles/about-pull-requests/)
|
||||
* [:us: Створення pull request](https://docs.github.com/en/free-pro-team@latest/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request)
|
||||
* [:us: Github Hello World](https://guides.github.com/activities/hello-world/)
|
||||
* [:us: Youtube - Github для початківців](https://www.youtube.com/watch?v=0fKg7e37bQE)
|
||||
* [:us: Youtube - Як зробити Fork репозиторія GitHub та відправити Pull Request](https://www.youtube.com/watch?v=G1I3HF4YWEw)
|
||||
* [:us: Youtube - Занурення у Markdown](https://www.youtube.com/watch?v=HUBNt18RFbo)
|
||||
**Ласкаво просимо до `Free-Programming-Books`!**
|
||||
|
||||
Не соромтеся задавати питання, адже кожен дописувач починав з першого Pull Request. Саме Ви можете стати нашим тисячним!
|
||||
Вітаємо нових учасників, навіть тих, хто робить свій перший Pull Request (PR) на GitHub. Якщо Ви один із них, ці ресурси можуть Вам допомогти:
|
||||
|
||||
Навіть якщо у Вас є досвід роботи з відкритим кодом, є речі, які можуть Вас збентежити. Після того, як Ви подасте свій PR, GitHub Actions запустить лінтер, який може виявити невеликі проблеми з пробілами або алфавітом. Якщо Ви отримаєте зелену кнопку, то все готово до перегляду, якщо ні, натисніть «Деталі» під перевіркою,щоб дізнатися що не сподобалося лінтеру. Вирішіть проблему та додайте комміт до свого Pull Request.
|
||||
* [Про Pull Requests](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-pull-requests) *(англійською мовою)*
|
||||
* [Створення pull request](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request) *(англійською мовою)*
|
||||
* [GitHub Hello World](https://docs.github.com/en/get-started/quickstart/hello-world) *(англійською мовою)*
|
||||
* [YouTube - GitHub для початківців](https://www.youtube.com/watch?v=0fKg7e37bQE) *(англійською мовою)*
|
||||
* [YouTube - Як зробити Fork репозиторія GitHub та відправити Pull Request](https://www.youtube.com/watch?v=G1I3HF4YWEw) *(англійською мовою)*
|
||||
* [YouTube - Занурення у Markdown](https://www.youtube.com/watch?v=HUBNt18RFbo) *(англійською мовою)*
|
||||
|
||||
На останок, якщо Ви не впевнені чи ресурс, який ви хочете додати, підходить для Free-Programming-Books, ознайомтеся з інструкціями в розділі [ДОДАТКИ](CONTRIBUTING.md). ([translations](README.md#translations))
|
||||
|
||||
Не соромтеся задавати питання, адже кожен дописувач починав з першого PR. Саме Ви можете стати нашим тисячним! So... why not join our [large, growing](https://www.apiseven.com/en/contributor-graph?chart=contributorOverTime&repo=ebookfoundation/free-programming-books) community.
|
||||
|
||||
<details align="center" markdown="1">
|
||||
<summary>Click to see the growth users vs. time graphs.</summary>
|
||||
|
||||
[](https://www.apiseven.com/en/contributor-graph?chart=contributorOverTime&repo=ebookfoundation/free-programming-books)
|
||||
|
||||
[](https://www.apiseven.com/en/contributor-graph?chart=contributorMonthlyActivity&repo=ebookfoundation/free-programming-books)
|
||||
|
||||
</details>
|
||||
|
||||
Навіть якщо у Вас є досвід роботи з відкритим кодом, є речі, які можуть Вас збентежити. Після того, як Ви подасте свій PR, ***GitHub Actions* запустить *linter*, який може виявити невеликі проблеми з пробілами або алфавітом**. Якщо Ви отримаєте зелену кнопку, то все готово до перегляду, якщо ні, натисніть «Деталі» під перевіркою,щоб дізнатися що не сподобалося лінтеру. Вирішіть проблему та додайте комміт до свого PR.
|
||||
|
||||
На останок, якщо Ви не впевнені чи ресурс, який ви хочете додати, підходить для `Free-Programming-Books`, ознайомтеся з інструкціями в розділі [ДОДАТКИ](CONTRIBUTING.md). ([translations](README.md#translations))
|
||||
|
||||
Reference in New Issue
Block a user