Skip to content

Commit 87b9e57

Browse files
caffeine-addicttShiroTohudependabot[bot]
authored
docs: Migrate docs (#99)
* docs: Ported docs here from the other repo Ref: python-thread/thread.ngjx.org#59 Closes: #89 Signed-off-by: AlexNg <contact@ngjx.org> Co-authored-by: Jun Xiang (カエデ) <contact@ngjx.org> Co-authored-by: ShiroTohu <shirotohu@shirotohu.dev> Co-authored-by: dependabot[bot] <support@github.com> * chore(gitignore): Merge gitignore files * chore(dependabot): Watch npm deps Ref: #89 * chore: Add root-level package.json Ref: 89 * chore: Integrate python into package.json * chore(deps-dev): Add prettier to docs * ci(lint): Update linting * style: Use prettier at the root-level * ci(test): Update tests * ci(linting): Update linting * test: Add test script * chore(deps): Update lockfile * style: Formatting * style: Add markdown ignore rules * style: Split into multiple lines * docs: Add contributing guide * docs: Remake steps * docs: Update links Updated with bash find/sed. It should have gotten all of it :> Ref: #89 Ref: python-thread/thread.ngjx.org#59 Signed-off-by: AlexNg <contact@ngjx.org> * style: Formatting * docs: Remove misc stuff * style: Update CODESTYLE 2 -> 4 spaces * docs: Update contributing --------- Signed-off-by: AlexNg <contact@ngjx.org> Co-authored-by: ShiroTohu <shirotohu@shirotohu.dev> Co-authored-by: dependabot[bot] <support@github.com>
1 parent 4ca4684 commit 87b9e57

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

81 files changed

+29223
-183
lines changed

.github/CODESTYLE.md

Lines changed: 29 additions & 30 deletions
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@ follow throughout the development of your contribution.
1616
as specified in [PEP 287](https://peps.python.org/pep-0287/)
1717
- Private attributes are to be prefixed with an underscore
1818
- Use of [typing](https://docs.python.org/3/library/typing.html) type hints
19-
- All files are to use 2 space indenting
19+
- All files are to use 4 space indenting
2020

2121
```python
2222
class ExampleClass:
@@ -31,28 +31,28 @@ class ExampleClass:
3131
public_attribute : int # type hint for integer is defined here
3232

3333
def __init__(
34-
self,
35-
public_attribute: int # type hint for parameters
34+
self,
35+
public_attribute: int # type hint for parameters
3636
) -> None: # the expected return value of method
37-
"""
38-
Initializes a ExampleClass
37+
"""
38+
Initializes a ExampleClass
3939
40-
Parameters
41-
----------
42-
:param public_attribute: example attribute
43-
"""
44-
self.public_attribute = public_attribute
45-
self.private_attribute = square(public_attribute)
40+
Parameters
41+
----------
42+
:param public_attribute: example attribute
43+
"""
44+
self.public_attribute = public_attribute
45+
self.private_attribute = square(public_attribute)
4646

4747
def square(self, value: int) -> int:
48-
"""
49-
Example method that square roots a value
50-
51-
Parameters
52-
----------
53-
:param value: value that you want squared
54-
"""
55-
return value**2
48+
"""
49+
Example method that square roots a value
50+
51+
Parameters
52+
----------
53+
:param value: value that you want squared
54+
"""
55+
return value**2
5656
```
5757

5858
## Markdown Guidelines
@@ -68,28 +68,27 @@ Currently, documentation for this project resides in markdown files.
6868

6969
```markdown
7070
<!--example markdown document-->
71+
7172
# Section
73+
7274
Lorem ipsum dolor sit amet, consectetur adipiscing elit,
73-
sed do eiusmod tempor incididunt ut labore et dolore
74-
magna aliqua. Ut enim ad minim veniam, quis nostrud
75-
exercitation ullamco laboris nisi ut aliquip ex ea
76-
commodo consequat. Duis aute irure dolor in
77-
reprehenderit in voluptate velit esse cillum dolore eu
78-
fugiat nulla pariatur. Excepteur sint occaecat cupidatat
79-
non proident, sunt in culpa qui officia deserunt mollit
75+
sed do eiusmod tempor incididunt ut labore et dolore
76+
magna aliqua. Ut enim ad minim veniam, quis nostrud
77+
exercitation ullamco laboris nisi ut aliquip ex ea
78+
commodo consequat. Duis aute irure dolor in
79+
reprehenderit in voluptate velit esse cillum dolore eu
80+
fugiat nulla pariatur. Excepteur sint occaecat cupidatat
81+
non proident, sunt in culpa qui officia deserunt mollit
8082
anim id est laborum. found [Lorem Ipsum Generator]
8183

82-
83-
8484
# Section 2
85+
8586
<ul>
8687
<li> Apple
8788
<li> Orange
8889
<li> Pineapple
8990
</ul>
9091

91-
92-
9392
[Lorem Ipsum Generator]: https://loremipsum.io/generator/
9493
```
9594

.github/CODE_OF_CONDUCT.md

Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -17,23 +17,23 @@ diverse, inclusive, and healthy community.
1717
Examples of behavior that contributes to a positive environment for our
1818
community include:
1919

20-
* Demonstrating empathy and kindness toward other people
21-
* Being respectful of differing opinions, viewpoints, and experiences
22-
* Giving and gracefully accepting constructive feedback
23-
* Accepting responsibility and apologizing to those affected by our mistakes,
20+
- Demonstrating empathy and kindness toward other people
21+
- Being respectful of differing opinions, viewpoints, and experiences
22+
- Giving and gracefully accepting constructive feedback
23+
- Accepting responsibility and apologizing to those affected by our mistakes,
2424
and learning from the experience
25-
* Focusing on what is best not just for us as individuals, but for the
25+
- Focusing on what is best not just for us as individuals, but for the
2626
overall community
2727

2828
Examples of unacceptable behavior include:
2929

30-
* The use of sexualized language or imagery, and sexual attention or
30+
- The use of sexualized language or imagery, and sexual attention or
3131
advances of any kind
32-
* Trolling, insulting or derogatory comments, and personal or political attacks
33-
* Public or private harassment
34-
* Publishing others' private information, such as a physical or email
32+
- Trolling, insulting or derogatory comments, and personal or political attacks
33+
- Public or private harassment
34+
- Publishing others' private information, such as a physical or email
3535
address, without their explicit permission
36-
* Other conduct which could reasonably be considered inappropriate in a
36+
- Other conduct which could reasonably be considered inappropriate in a
3737
professional setting
3838

3939
## Enforcement Responsibilities
@@ -105,7 +105,7 @@ Violating these terms may lead to a permanent ban.
105105
### 4. Permanent Ban
106106

107107
**Community Impact**: Demonstrating a pattern of violation of community
108-
standards, including sustained inappropriate behavior, harassment of an
108+
standards, including sustained inappropriate behavior, harassment of an
109109
individual, or aggression toward or disparagement of classes of individuals.
110110

111111
**Consequence**: A permanent ban from any sort of public interaction within
@@ -124,4 +124,4 @@ enforcement ladder](https://github.com/mozilla/diversity).
124124

125125
For answers to common questions about this code of conduct, see the FAQ at
126126
https://www.contributor-covenant.org/faq. Translations are available at
127-
https://www.contributor-covenant.org/translations.
127+
https://www.contributor-covenant.org/translations.

.github/ISSUE_TEMPLATE/1-bug-report.md

Lines changed: 14 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -4,63 +4,58 @@ about: "Report an issue to help the project improve."
44
title: "[Bug] "
55
labels: "Type: Bug"
66
assignees: caffeine-addictt
7-
87
---
98

109
# Bug report
10+
1111
Your issue may already be reported!
1212
Please check out our [active issues](https://github.com/python-thread/thread/issues) before creating one.
1313

14-
15-
1614
## Expected Behavior
15+
1716
<!--
1817
If you're describing a bug, tell us what should happen
1918
If you're suggesting a change/improvement, tell us how it should work
2019
2120
Please include screenshots and/or code snippets if applicable
2221
-->
2322

24-
25-
2623
## Current Behavior
24+
2725
<!--
2826
If describing a bug, tell us what happens instead of the expected behavior
2927
If suggesting a change/improvement, explain the difference from current behavior
3028
3129
Please include screenshots and/or code snippets if applicable
3230
-->
3331

34-
35-
3632
## Is this a regression?
33+
3734
<!--
3835
Did this behaviour use to work in previous versions?
3936
If yes, what is the latest version where this behaviour is not present?
4037
-->
4138

42-
43-
4439
## Possible Solution
40+
4541
<!--
4642
Not obligatory, but suggest a fix/reason for the bug
4743
or ideas how to implement the addition or change
4844
-->
4945

50-
51-
5246
## Steps to Reproduce (for bugs)
47+
5348
<!--
5449
Provide a link to a live example, or an unambiguous set of steps to reproduce this bug.
5550
-->
51+
5652
1.
5753
2.
5854
3.
5955
4.
6056

61-
62-
6357
## Context
58+
6459
<!--
6560
How has this issue affected you?
6661
What are you trying to accomplish?
@@ -70,13 +65,13 @@ Providing context helps us come up with a solution that is most useful in the re
7065
Please include screenshots and/or code snippets if applicable
7166
-->
7267

73-
74-
7568
## Your Environment
69+
7670
<!--
7771
Include as many relevant details about the environment you experienced the bug in
7872
-->
79-
* Version used:
80-
* Python version:
81-
* Link to your project:
82-
* Operating System and version (desktop or mobile):
73+
74+
- Version used:
75+
- Python version:
76+
- Link to your project:
77+
- Operating System and version (desktop or mobile):

.github/ISSUE_TEMPLATE/2-failing-test.md

Lines changed: 5 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -4,37 +4,33 @@ about: "Report failing tests or CI jobs."
44
title: "[Test] "
55
labels: "Type: Test"
66
assignees: caffeine-addictt
7-
87
---
98

109
# Failing Test
10+
1111
Your issue may already be reported!
1212
Please check out our [active issues](https://github.com/python-thread/thread/issues) before creating one.
1313

14-
15-
1614
## Which Jobs/Tests are Failing?
17-
*
18-
1915

16+
-
2017

2118
## Reason for Failure
19+
2220
<!--
2321
Why is/are this/these job/test(s) failing?
2422
What are we missing to make it pass?
2523
-->
2624

27-
28-
2925
## Media Prove
26+
3027
<!--
3128
If applicable, add screenshots or code snippets to explain the issue
3229
If not applicable, remove this field
3330
-->
3431

35-
36-
3732
## Additional Context
33+
3834
<!--
3935
Any other extra context or information
4036
-->

.github/ISSUE_TEMPLATE/3-docs-bug.md

Lines changed: 4 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -4,23 +4,21 @@ about: "Report an issue in the project's documentation or README.md file."
44
title: "[Docs] "
55
labels: "Documentation"
66
assignees: caffeine-addictt
7-
87
---
98

109
# Documentation Issue Report
10+
1111
Your issue may already be reported!
1212
Please check out our [active issues](https://github.com/python-thread/thread/issues) before creating one.
1313

14-
15-
1614
## Describe the Bug
15+
1716
<!--
1817
A clear and concise description of the bug
1918
-->
2019

21-
22-
2320
## Steps to Reproduce
21+
2422
<!--
2523
e.g.:
2624
1. Navigate to docs/x
@@ -33,9 +31,8 @@ e.g.:
3331
3.
3432
4.
3533

36-
37-
3834
## Additional Context
35+
3936
<!--
4037
Any other extra context or information
4138
-->

.github/ISSUE_TEMPLATE/4-feature-request.md

Lines changed: 5 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -4,40 +4,36 @@ about: "Suggest an idea or possible new feature for this project."
44
title: "[Feature] "
55
labels: "Type: Feature"
66
assignees: caffeine-addictt
7-
87
---
98

109
# Feature Request
10+
1111
Your issue may already be reported!
1212
Please check out our [active issues](https://github.com/python-thread/thread/issues) before creating one.
1313

14-
15-
1614
## Is Your Feature Request Related to an Issue?
15+
1716
<!--
1817
If yes, provide a clear and concise description of what the problem is
1918
E.g.:
2019
Issue #
2120
I'm always frustrated when...
2221
-->
2322

24-
25-
2623
## Describe the Solution You'd Like
24+
2725
<!--
2826
A clear and concise description of what you'd like
2927
-->
3028

31-
32-
3329
## Describe Alternatives You've Considered
30+
3431
<!--
3532
A clear and concise description of other alternatives you have considered
3633
-->
3734

38-
39-
4035
## Additional Context
36+
4137
<!--
4238
Any other extra context or information
4339
-->

0 commit comments

Comments
 (0)