Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/eddiejaoude/book-open-source-tips
Open Source book on Open Source Tips
https://github.com/eddiejaoude/book-open-source-tips
book code community github newcomers opensource tips
Last synced: 6 days ago
JSON representation
Open Source book on Open Source Tips
- Host: GitHub
- URL: https://github.com/eddiejaoude/book-open-source-tips
- Owner: eddiejaoude
- License: mit
- Created: 2016-11-05T03:15:33.000Z (about 8 years ago)
- Default Branch: master
- Last Pushed: 2023-05-20T07:15:05.000Z (over 1 year ago)
- Last Synced: 2024-05-02T05:40:38.979Z (8 months ago)
- Topics: book, code, community, github, newcomers, opensource, tips
- Language: Makefile
- Homepage: https://eddiejaoude.github.io/book-open-source-tips/
- Size: 1.2 MB
- Stars: 263
- Watchers: 18
- Forks: 85
- Open Issues: 37
-
Metadata Files:
- Readme: README.md
- Contributing: .github/CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: .github/CODE_OF_CONDUCT.md
Awesome Lists containing this project
- jimsghstars - eddiejaoude/book-open-source-tips - Open Source book on Open Source Tips (Makefile)
README
[](https://pipeline.dashboardhub.io/environments/f39a2d40-2045-11e8-a435-ade829eb4121)
# Open Source Tips
Open Source book on Open Source Tips
| Language | Status | Link |
| :--- | :--- | :--- |
| English | - | https://eddiejaoude.github.io/book-open-source-tips/ |
| Spanish | In progress | https://eddiejaoude.github.io/book-open-source-tips/index-es.html |
| Filipino | In progress | https://eddiejaoude.github.io/book-open-source-tips/index-fil.html |
This book contains some common **DOs** & **DON'Ts** for Open Source software.
The Open Source community is thriving. Each day the number of Open Source projects grow, as does the army of contributors that maintain them. While this is exciting for the industry, it can be daunting as a developer new to the community. This book aims to provide some tips for newcomers to help them avoid the pitfalls of Open Source development and learn from the community's collective wisdom.
As the ancient proverb goes, _Time and tide [and technology] wait for no man_. And to the best of our ability, neither will this book. Remember to check the version number for updates!
We would love your help in keeping this book updated. Your comments, suggestions, and pull requests are most welcome.
Open Source is dominating the software industry. Its champions include well-known organisations like Facebook, Twitter and Netflix, but more significantly, an army of passionate individual developers around the world. Their efforts have impacted almost every part of computer science, culminating in millions of open source projects, with billions of lines of code!
While this abundant ecosystem has been of huge benefit to the whole industry, it can also make it difficult for newcomers to know where to start. If you're a newcomer, you might be faced with questions such as _"How can I contribute to the Open Source community?"_ Or, _"How do I choose between so many competing projects?"_ The following DOs and DON'Ts aim to address some of those basic questions, and offer some pointers to aspiring Open Source developers.
[Let's dive right in](https://eddiejaoude.github.io/book-open-source-tips/).
All changes in `master` branch are automatically deployed to the above URL.
## Code of Conduct
* [Code of Conduct](.github/CODE_OF_CONDUCT.md)
## Dependencies
* [Ascii Doctor](http://asciidoctor.org)
## Quick Start
### Install
* AsciiDoctor (html)
```bash
gem install asciidoctor
```
* AciiDoctor (pdf)
```bash
gem install --pre asciidoctor-pdf
```
* Atom preview [plugin](https://atom.io/packages/asciidoc-preview) (optional)
```bash
apm install asciidoc-preview
```
* VS Code preview [plugin](https://marketplace.visualstudio.com/items?itemName=joaompinto.asciidoctor-vscode) (optional)
Launch VS Code Quick Open (Windows: `ctrl+p`, Mac: `cmd+p`), paste the following command, and press enter:
```bash
ext install joaompinto.asciidoctor-vscode
```
### Source code
Source code is in `src/` directory.
### Generate html, pdf etc
* To generate the output in **html** & **pdf**:
```bash
make
```
### Live Server in Codespace
If you are opening up in GitHub Codespace or VSCode with a DevContainer, then Live Server extension is installed and the port mapping to 5500 setup. Just start liveshare through the command pallet or with 'alt + l then alt + o' then go to remote explorer and open the Live Server in a new browser tab.