Skip to content

Commit 6ee9ce9

Browse files
authored
docs: update contributing guidelines (#125)
* docs: update contributing guidelines * lint
1 parent 2b0b4ae commit 6ee9ce9

File tree

2 files changed

+34
-36
lines changed

2 files changed

+34
-36
lines changed

CONTRIBUTING.md

+20-15
Original file line numberDiff line numberDiff line change
@@ -1,28 +1,33 @@
11
## How to contribute
22

3-
Thank you for considering contributing to coURLan!
43

5-
Here are some important resources:
4+
If you value this software or depend on it for your product,
5+
consider sponsoring it and contributing to its codebase.
6+
Your support will help ensure the sustainability and growth of the project.
67

7-
* [List of currently open issues](https://github.com/adbar/courlan/issues) (no pretention to exhaustivity!)
8-
* [How to Contribute to Open Source](https://opensource.guide/how-to-contribute/)
8+
There are many ways to contribute:
99

10-
There are many ways to contribute, you could:
10+
* Sponsor the project: Show your appreciation [on GitHub](https://github.com/sponsors/adbar) or [ko-fi.com](https://ko-fi.com/adbarbaresi).
11+
* Find bugs and submit bug reports: Help making Courlan an even more robust tool.
12+
* Write code: Fix bugs or add new features by writing [pull requests](https://docs.github.com/en/pull-requests) with a list of what you have done.
1113

12-
* Improve the documentation
13-
* Find bugs and submit bug reports
14-
* Submit feature requests
15-
* Write tutorials or blog posts
16-
* Write code
1714

18-
## Submitting changes
15+
A special thanks to the [contributors](https://github.com/adbar/courlan/graphs/contributors) who have played a part in Courlan.
1916

20-
Please send a [GitHub Pull Request to coURLan](https://github.com/adbar/courlan/pull/new/master) with a clear list of what you've done (read more about [pull requests](http://help.github.com/pull-requests/)).
2117

22-
**Working on your first Pull Request?** See this tutorial: [How To Create a Pull Request on GitHub](https://www.digitalocean.com/community/tutorials/how-to-create-a-pull-request-on-github)
18+
## Testing and evaluating the code
2319

24-
For further questions you can contact me by way of [GitHub issues](https://github.com/adbar/courlan/issues), [Twitter](https://twitter.com/adbarbaresi) or [E-Mail](https://adrien.barbaresi.eu/).
20+
Here is how you can run the tests and code quality checks. Pull requests will only be accepted if the changes are tested and if they there are no errors.
21+
22+
1. Install the necessary packages with `pip install courlan[dev]`
23+
2. Run the tests and code quality tools:
24+
- Tests with `pytest`
25+
- Type checking with `mypy` on the directory: `mypy courlan/`
26+
- Code formatting with `black` on the directory as well
27+
28+
29+
For further questions you can use [GitHub issues](https://github.com/adbar/courlan/issues) or [E-Mail](https://adrien.barbaresi.eu/).
2530

2631
Thanks,
2732

28-
Adrien
33+
Adrien

README.md

+14-21
Original file line numberDiff line numberDiff line change
@@ -411,32 +411,25 @@ Details of strict URL filtering can be reviewed and changed in the file
411411
locally](https://packaging.python.org/tutorials/installing-packages/#installing-from-a-local-src-tree).
412412

413413

414-
## Contributing
415-
416-
[Contributions](https://github.com/adbar/courlan/blob/master/CONTRIBUTING.md)
417-
are welcome!
418-
419-
Feel free to file issues on the [dedicated
420-
page](https://github.com/adbar/courlan/issues).
421-
422-
423414
## Author
424415

425-
Developed with practical applications of academic research in mind, this software
426-
is part of a broader effort to derive information from web documents.
427-
Extracting and pre-processing web texts to the exacting standards of
428-
scientific research presents a substantial challenge.
429-
This software package simplifies text data collection and enhances corpus quality,
430-
it is currently used to build [text databases for research](https://www.dwds.de/d/k-web).
416+
Initially launched to create text databases for research purposes
417+
at the Berlin-Brandenburg Academy of Sciences (DWDS and ZDL units),
418+
this package continues to be maintained but its future development
419+
depends on community support.
431420

432-
- Barbaresi, A. "[Trafilatura: A Web Scraping Library and
433-
Command-Line Tool for Text Discovery and
434-
Extraction](https://aclanthology.org/2021.acl-demo.15/)."
435-
*Proceedings of ACL/IJCNLP 2021: System Demonstrations*, 2021, pp. 122-131.
421+
**If you value this software or depend on it for your product, consider
422+
sponsoring it and contributing to its codebase**. Your support
423+
[on GitHub](https://github.com/sponsors/adbar) or [ko-fi.com](https://ko-fi.com/adbarbaresi)
424+
will help maintain and enhance this package.
425+
Visit the [Contributing page](https://github.com/adbar/courlan/blob/master/CONTRIBUTING.md)
426+
for more information.
436427

437-
Contact: see [homepage](https://adrien.barbaresi.eu/).
428+
Reach out via the software repository or the [contact
429+
page](https://adrien.barbaresi.eu/) for inquiries, collaborations, or
430+
feedback.
438431

439-
Software ecosystem: see [this
432+
For more on Courlan's' software ecosystem see [this
440433
graphic](https://github.com/adbar/trafilatura/blob/master/docs/software-ecosystem.png).
441434

442435

0 commit comments

Comments
 (0)