Skip to content

Commit b06cfc1

Browse files
committed
align other docs, except Yoruba translations, with the style guide
1 parent 6bdced1 commit b06cfc1

File tree

3 files changed

+63
-40
lines changed

3 files changed

+63
-40
lines changed

FAQ.md

+17-15
Original file line numberDiff line numberDiff line change
@@ -1,49 +1,51 @@
1-
# Frequently Asked Questions
1+
# Frequently asked questions
22

33
If you are working with Black Python Devs, you may receive one or more of these questions. This document guides you on how to respond to such frequently asked questions.
44

5-
## Is this Community Only for Black People?
5+
## Is this community only for black people?
66

77
The Black Python Devs community is meant to extend the Python community to black and colored Pythonistas of all skill levels.
88

9-
We understand that [blackness and colorism is a construct that is often used to segregate or diminish melanated individuals and doesn't always match a person's self-identity](https://blackpythondevs.com/2024-05-22-why-we-use-colored-and-coloured/). We allow people from all walks of life to join our community.
9+
We understand that [blackness and colorism are constructs that are often used to segregate or diminish individuals and don't always match a person's self-identity](https://blackpythondevs.com/2024-05-22-why-we-use-colored-and-coloured/). We allow people from all walks of life to join our community.
1010

11-
## Is this Community Welcome to Everyone?
11+
## Is this community welcome to everyone?
1212

1313
The only people who are asked to leave the community are those who join with the intent of violating our [Code of Conduct](https://github.com/BlackPythonDevs/.maintainers?tab=coc-ov-file#readme).
1414

15-
## Is this a Religious or Politically Backed Group?
15+
## Is this a religious or politically backed group?
1616

17-
No, this community does not align with any religious or political group. People of all religions and political beliefs are allowed to join and participate in accordance with our [Code of Conduct](https://github.com/BlackPythonDevs/.maintainers?tab=coc-ov-file#readme).
17+
No, this community doesn't align with any religious or political group. People of all religions and political beliefs are allowed to join and participate in accordance with our [Code of Conduct](https://github.com/BlackPythonDevs/.maintainers?tab=coc-ov-file#readme).
1818

19-
## Where is Black Python Devs Based?
19+
## Where is Black Python Devs based?
2020

2121
We are registered as a non-profit in the United States of America and as a fiscal sponsor of the GNOME Foundation.
2222

23-
## Does Black Python Devs have Resources for Beginners?
23+
## Does Black Python Devs have resources for beginners?
2424

2525
While we have partnerships that give us access to beginner resources, we currently do not author any content that would allow us to support beginners with a learning program.
2626

27-
## Does GNOME Run this Community?
27+
## Does GNOME run this community?
2828

29-
No, GNOME doesn't run the Black Python Devs Community. GNOME is our fiscal host, which means they help us in issuing payments in accordance with our programs and policies. However, if we attempt to spend money that we don't have or spend money in a way that violates our non-profit status in the United States, GNOME can come in to prevent us from doing this.
29+
No, GNOME doesn't run the Black Python Devs community. GNOME is our fiscal host, which means they help us in issuing payments following our programs and policies.
3030

31-
## Does Black Python Devs Meet in Person?
31+
If we attempt to spend money that we don't have or spend money in a way that violates our non-profit status in the United States, GNOME can come in to prevent us from doing this.
32+
33+
## Does Black Python Devs meet in person?
3234

3335
We are currently working on making this possible. Be sure to keep an eye on our [Meetup](https://www.meetup.com/pro/black-python-devs/) page.
3436

35-
## Does Black Python Devs Support Existing Meetups?
37+
## Does Black Python Devs support existing meetups?
3638

3739
The Black Python Devs community supports meetups that are related to what we do. We aim to support local Python leaders in attracting more black and colored Pythonistas of all skill levels.
3840

39-
## Does Black Python Devs Support Conferences?
41+
## Does Black Python Devs support conferences?
4042

4143
Yes, Black Python Devs works with conferences to help make them safer, more accessible, and equitable to black and colored people. This support can be in the form of monetary support to help them attend the event. This is often determined based on the location and size of the event, the organizing team and their needs, and the opportunities available to provide meaningful support to the black and colored people in the area.
4244

43-
## Does Black Python Devs Send Money to Developers to Attend Conferences?
45+
## Does Black Python Devs send money to developers to attend conferences?
4446

4547
Currently, Black Python Devs doesn't send money directly to individuals unless they are awarded a grant related to a Black Python Devs event. When possible, Black Python Devs works with third-party vendors to ensure awards are used in accordance with the grant plans.
4648

47-
## Does the Black Python Devs Community Work in All Countries?
49+
## Does the Black Python Devs community work in all countries?
4850

4951
As Black Python Devs is registered as a US non-profit, we are barred from working with some [countries and entities based on the US Sanction System](https://ofac.treasury.gov/sanctions-programs-and-country-information).

guidelines.md

+21-6
Original file line numberDiff line numberDiff line change
@@ -1,15 +1,19 @@
1-
# Yoruba Language Writing Guide
1+
# Yoruba language writing guide
22

33
## Introduction (òrò àkoso)
4+
45
Yoruba is a language spoken predominantly in southwestern Nigeria and parts of Benin and Togo. Proper writing of Yoruba involves understanding its alphabet, tonal system, and grammatical structures. This guide provides a comprehensive overview of these elements to help you write Yoruba correctly.
56

6-
## Yoruba Alphabet (Ọfẹ́ẹ̀ àlà Yorùbá)
7+
## Yoruba alphabet (Ọfẹ́ẹ̀ àlà Yorùbá)
8+
79
Yoruba uses the Latin alphabet with additional diacritical marks to represent its unique sounds and tones.
810

911
### Vowels (Àwọn ẹlẹ́rìí)
12+
1013
Yoruba has seven oral vowels and five nasal vowels.
1114

12-
#### Oral Vowels
15+
#### Oral vowels
16+
1317
| Letter | Pronunciation |
1418
| ------ | ------------- |
1519
| a | as in "father" |
@@ -20,7 +24,8 @@ Yoruba has seven oral vowels and five nasal vowels.
2024
|| as in "ought" |
2125
| u | as in "flute" |
2226

23-
#### Nasal Vowels
27+
#### Nasal vowels
28+
2429
| Letter | Pronunciation |
2530
| ------ | ------------- |
2631
| an | nasalized "a" |
@@ -30,6 +35,7 @@ Yoruba has seven oral vowels and five nasal vowels.
3035
| un | nasalized "u" |
3136

3237
### Consonants
38+
3339
Yoruba consonants are similar to those in English but with some unique sounds.
3440

3541
| Letter | Pronunciation |
@@ -53,22 +59,26 @@ Yoruba consonants are similar to those in English but with some unique sounds.
5359
| w | as in "water" |
5460
| y | as in "yes" |
5561

56-
## Tonal Marks (Àwọn iṣẹ́lẹ̀ àwọn irò-ọ̀rọ̀)
62+
## Tonal marks (Àwọn iṣẹ́lẹ̀ àwọn irò-ọ̀rọ̀)
63+
5764
Yoruba is a tonal language, meaning that the pitch at which a word is pronounced can change its meaning. There are three primary tones:
5865

5966
- **High Tone**: Indicated by an acute accent (´), e.g., á
6067
- **Mid Tone**: Usually unmarked, e.g., a
6168
- **Low Tone**: Indicated by a grave accent (`), e.g., à
6269

6370
### Examples (Àfiwé tai àpẹẹrẹ)
71+
6472
- **High Tone**: á, é, í, ó, ú
6573
- **Mid Tone**: a, e, i, o, u
6674
- **Low Tone**: à, è, ì, ò, ù
6775

68-
## Syllable Structure
76+
## Syllable structure
77+
6978
Yoruba syllables typically follow a consonant-vowel (CV) structure, but can also be V, N (nasal consonant), CVV, or CVN.
7079

7180
### Examples (Àfiwé tai àpẹẹrẹ)
81+
7282
- CV: ba, de, fi
7383
- V: a, e, o
7484
- N: m, n
@@ -93,21 +103,25 @@ Yoruba pronouns change based on their function in the sentence.
93103
| They | wọ́n | wọ́n | tiwọn |
94104

95105
### Verbs (àwọn òrò-ìṣe)
106+
96107
Verbs in Yoruba do not conjugate according to tense. Instead, tense is indicated by particles before the verb.
97108

98109
- **Present**: n + verb (e.g., n lọ - "is going")
99110
- **Past**: ti + verb (e.g., ti lọ - "has gone")
100111
- **Future**: máa + verb (e.g., máa lọ - "will go")
101112

102113
### Examples (Àfiwé tai àpẹẹrẹ)
114+
103115
- Present: Mo n lọ (I am going)
104116
- Past: Mo ti lọ (I have gone)
105117
- Future: Mo máa lọ (I will go)
106118

107119
## Punctuation (àmì ọ̀rọ̀ tabi àmì óhun)
120+
108121
Yoruba uses standard punctuation marks, but there are specific rules for their usage, especially concerning tone marks and vowel elongation.
109122

110123
## Common Phrases
124+
111125
- **Hello**: Ẹ n lẹ
112126
- **Good morning**: Ẹ káàárọ̀
113127
- **Thank you**: Ẹ ṣé
@@ -123,6 +137,7 @@ Yoruba uses standard punctuation marks, but there are specific rules for their u
123137

124138

125139
## Conclusion (ìparí)
140+
126141
Writing Yoruba properly requires attention to its unique alphabet, tonal system, and grammatical rules. By adhering to these guidelines, you can ensure clarity and correctness in your written Yoruba.
127142

128143
---

initiatives.md

+25-19
Original file line numberDiff line numberDiff line change
@@ -1,39 +1,45 @@
1-
# Black Python Devs Initiatives
1+
# Black Python Devs' initiatives
22

33
Initiatives are the driving efforts of our community.
44

5-
## Build Local Community
5+
## Building local communities
66

7-
We believe it is incredibly important that local community is supported as much as possible.
7+
We believe it's important that local communities are supported as much as possible.
88

99
They raise the overall capability of Pythonistas in their area with much more consistency.
1010

11-
### Our Strategy
11+
### Our strategy
1212

13-
- Sponsor Local Conferences/Meetups organized by Black Python Devs Community Leaders
14-
- Sponsorships go towards tickets for local community members to attend
13+
Our strategies in supporting local communities are as follows:
1514

16-
## Leadership Opportunity Fund
15+
- sponsor local conferences/meetups organized by the Black Python Devs community leaders
16+
- sponsorships go towards tickets for local community members to attend
1717

18-
It's important that community leaders are able to grow and develop. Which is why we hope that we can get local leaders to global events where they can connect with other leaders in the community, learn from global professionals, and gain global support for their local initiatives.
18+
## Leadership opportunity fund
1919

20-
That being said investments into opportunity grants are extremely limited and not everyone can fund attending these larger events. Furthermore, these opportunities often mean that the recipient has to personally fund their travel, only receiving reimbursement after the fact. Not everyone can get access to higher limit credit cards, loans.
20+
Community leaders must be able to grow and develop. This is why we hope that we can get local leaders to global events where they can connect with other leaders in the community, learn from global professionals, and gain global support for their local initiatives.
2121

22-
Lastly the process for getting visas to attend can be confusing and daunting and different depending on the country. In some cases you don't know if you can get your visa appointment in time once getting approval.
22+
That being said, investments in opportunity grants are extremely limited, and not everyone can afford to attend these larger events. Furthermore, these opportunities often mean that the recipient has to personally fund their travel, only receiving reimbursement after the fact. Not everyone can get access to higher limit credit cards, loans.
2323

24-
### Our Strategy
24+
Lastly, the process for getting visas to attend can be confusing and daunting, and different depending on the country. In some cases, you don't know if you can get your visa appointment in time once you get approval.
25+
26+
### Our strategy
2527

26-
- Offer a limited grant to community leaders to cover expenses around visa appointments.
27-
- Work with travel professionals to coordinate flights, hotels, and transportation while travelling
28-
- Work with conferences to make their opportunity grants accessible to as many as possible addressing the concerns of our community leaders.
28+
Our strategies in supporting community leaders are as follows:
2929

30-
## Build Black Excellence Equally
30+
- offer a limited grant to community leaders to cover expenses around visa appointments
31+
- work with travel professionals to coordinate flights, hotels, and transportation while traveling
32+
- work with conferences to make their opportunity grants accessible to as many as possible
3133

32-
Opportunities for Black professionals skew towards those with the ability to pay their way into a comfortable life. We can't change how the game is played but we can play a different game.
34+
## Build black excellence
3335

34-
Black Python Devs will work with content creators to give as many opportunities to Black developers for free or at a discounted rate. This involves coordinating with sponsors. What we can't partner on, we will find from within. We aim to create opportunities for Black Python developers to network with one another, learn together, and share their knowledge with our ever growing community.
36+
Opportunities for Black professionals skew towards those with the ability to pay their way into a comfortable life. We can't change how the game is played, but we can play a different game.
37+
38+
Black Python Devs will work with content creators to give as many opportunities to black developers for free or at a discounted rate. This involves coordinating with sponsors. What we can't partner on, we will find from within. We aim to create opportunities for black Python developers to network with one another, learn together, and share their knowledge with our ever-growing community.
3539

3640
### Our Strategy
3741

38-
- Partner with content creators for bulk discounts on learning content
39-
- Host regular events and programs in our Discord for folks to skill up, network, and learn from one another
42+
Our strategies in supporting black excellence are as follows:
43+
44+
- partner with content creators for bulk discounts on learning content
45+
- host regular events and programs in our Discord for folks to skill up, network, and learn from one another

0 commit comments

Comments
 (0)