diff --git a/README.md b/README.md index 8843024..a3e6414 100644 --- a/README.md +++ b/README.md @@ -10,9 +10,12 @@ a Linux distribution [with base on musl libc](alpine/base-with-muslc-and-busybox and [defaults commands to Busybox](alpine/base-with-muslc-and-busybox.md#defaults-to-busybox), with option to change that! -Where to start? Check the [Tutorials and Docs](#tutorials-and-docs) section. [This is not an official project](alpine/copyright.md) +Where to start? Check the next section. -How to contribute to this project? Check the [How to contribute](#how-to-contribute) section. +### Tutorials and Docs + +1. [Newbies](newbie/README.md), not mandatory but recommended you start to read the [Newbies](newbie/README.md). +2. [Tutorials](tutorials/README.md), for impatients if you have computer or only a phone, read the [Tutorials](tutorials/README.md) ### About alpine @@ -20,15 +23,6 @@ How to contribute to this project? Check the [How to contribute](#how-to-contrib * [Comparison with other distros](alpine/comparison-with-other-distros.md) * [Alpine Linux Releases](alpine/releases.md) -### Tutorials and Docs - -* [Newbies](newbie/README.md) -* [Tutorials](tutorials/README.md) - -### How to contribute - -* [Contribution.md](alpine/contribution.md) - ### Social network and contact - 🗯 IRC @@ -44,6 +38,10 @@ How to contribute to this project? Check the [How to contribute](#how-to-contrib - Matrix - 👥 https://matrix.to/#/#alpine-linux-english:matrix.org +### How to contribute + +* [Contribution.md](alpine/contribution.md) + # LICENSE **CC BY-NC-SA**: the project allows reusers to distribute, remix, adapt, and build upon the material diff --git a/tutorials/README.md b/tutorials/README.md index 772cfd4..d01299e 100644 --- a/tutorials/README.md +++ b/tutorials/README.md @@ -1,8 +1,32 @@ +Alpine Linux tutorias and how tos +================================= -## Documentation +This category section will try to guide new ones with almost basic enought knowledge of Linux. -* [community-way](community-way) -* [professional-way](professional-way) +**CONSIDERATIONS**: Please check the [Feature Differences OF THIS ALPINE LINUX](../newbies/README.md#feature-differences) +but those are the main ones you should considering before usage of Alpine linux: + +1. Alpine Linux **is designed for power users, with security and simplicity in mind**. +2. Alpine Linux **is not for newbies most knowed as new baby users or windosers**. +3. It is built around musl libc, not glibc, which means there might be incompatibilites with some packages +4. Its main utilities (coreutils) are derived from busybox and suckless, so all commands are pretty simplistic + +**PREREQUISITES**: Please check the [newbie alpine preparation requirements for you](../newbie/alpine-newbie-prepare.md) +but you can use linux using [termux](tutorial-alpine-in-phone.md) or [ish](tutorial-alpine-in-phone.md) on your phone. + +* **Manners**, you will must have a vocation for reading and analysis. +* **Time**, you will need time, cos you will need to read a lot! +* **Computer**, you should **have a pc, or phone**, and must have a UNIX like operating system, like MAC/IOS or Androit/Linux +* **Internet**, and minimal bandwitch of internet network.. + +## TUTORIALS AND HOW TOS + +We divided the guides, tutorials and howtos in 3 main sections, one for new new fresh users (newbies) +and the others two for impatients: + +1. [newbies](../newbies) +2. [community-way](community-way) +3. [professional-way](professional-way) ## Help online directly @@ -16,6 +40,19 @@ - 🇧🇬 https://t.me/alpine_linux_bulgarian (dual english bulgarian, low activity) - 🇨🇳 https://t.me/alpine_linux_chinese (dual english chinese, low activity) - 📡 https://t.me/opentechnologies (open languajes but english as main) -- Matrix +- ⛓ Matrix - 👥 https://matrix.to/#/#alpine-linux-english:matrix.org +# LICENSE + +**CC BY-NC-SA**: this project allows reusers to distribute, remix, adapt, and build upon the material +in any medium or format for noncommercial purposes only, and only so long as attribution is given +to the creators involved. If you remix, adapt, or build upon the material, you must license the modified +material under identical terms, includes the following elements: + +* **BY** – Credit must be given to the creator of each content respectivelly, starting at the first contributor. +* **NC** – Only noncommercial uses of the work are permitted, with exceptions if you fill an issue here! +* **SA** – Adaptations must be shared under the same terms, you must obey this terms and do not change it. + +For more information check the [../alpine/copyright.md](../alpine/copyright.md) + diff --git a/tutorials/community-way/README.md b/tutorials/community-way/README.md index e418b01..cbb22b5 100644 --- a/tutorials/community-way/README.md +++ b/tutorials/community-way/README.md @@ -1,5 +1,65 @@ +Community way of alpine wiki documentation +========================================= + +Those documents are community made and may or not may have updated. +For more up to date documents check [the main index at ../tutorials/README.md](../tutorials/README.md) + +## INSTALL + +## PHONES + +* [alpine-tutorial-in-phones.md](alpine-tutorial-in-phones.md) + * [phones-androit-allow-external-apps-install.md](phones-androit-allow-external-apps-install.md) + +## DESKTOPS + +* [alpine-tutorial-desktops-openbox-fast-forward.md](alpine-tutorial-desktops-openbox-fast-forward.md) + +## SERVERS + +* [servers-howto-setup-PXE-service-for-others-linuxes-ES.md](servers-howto-setup-PXE-service-for-others-linuxes-ES.md) + +## DESKTOP + TODO NOTE: in this directory (we will called category spaces) each member or contributor will or can put their own tutorial or guides -eacho one must started with the word "tutorial" or "guide" and hav the "alpine" word in second.. rest of the name can be whatever and do not have spaces.. each word must be separated with "-" \ No newline at end of file +## Convention for naming the files: + +1. each one must started with the word "alpine" unless are just a extra document like the androit external apps +2. must be followed "tutorial" or "guide" or "howto" +3. rest of the name can be whatever and do not have spaces.. each word must be separated with "-" +4. the name must not contains any simbol or space, only numbers and letters and "-" are allowed +5. the extension of the file must be ".md" +6. you can upload extra support files like scripts shell or photos +7. the name of each extra files must be same as the document and extra word to idetify + +## Help online directly + +- 🗯 IRC + - 💬 `##alpine_telegram_english` + - 💬 `#alpine_linux_english` +- 📱 Telegram https://t.me/alpine_linux + - 🇬🇧 https://t.me/alpine_linux_english + - 🇷🇺 https://t.me/alpine_linux_pycckuu (dual english russian, low activity) + - 🇨🇴 https://t.me/alpine_linux_espanol + - 🇧🇬 https://t.me/alpine_linux_bulgarian (dual english bulgarian, low activity) + - 🇨🇳 https://t.me/alpine_linux_chinese (dual english chinese, low activity) + - 📡 https://t.me/opentechnologies (open languajes but english as main) +- ⛓ Matrix + - 👥 https://matrix.to/#/#alpine-linux-english:matrix.org + +# LICENSE + +**CC BY-NC-SA**: this project allows reusers to distribute, remix, adapt, and build upon the material +in any medium or format for noncommercial purposes only, and only so long as attribution is given +to the creators involved. If you remix, adapt, or build upon the material, you must license the modified +material under identical terms, includes the following elements: + +* **BY** – Credit must be given to the creator of each content respectivelly, starting at the first contributor. +* **NC** – Only noncommercial uses of the work are permitted, with exceptions if you fill an issue here! +* **SA** – Adaptations must be shared under the same terms, you must obey this terms and do not change it. + +For more information check the [../alpine/copyright.md](../alpine/copyright.md) + diff --git a/tutorials/community-way/tutorial-alpine-in-phone.md b/tutorials/community-way/alpine-tutorial-in-phones.md similarity index 79% rename from tutorials/community-way/tutorial-alpine-in-phone.md rename to tutorials/community-way/alpine-tutorial-in-phones.md index 4cba766..f767cf5 100644 --- a/tutorials/community-way/tutorial-alpine-in-phone.md +++ b/tutorials/community-way/alpine-tutorial-in-phones.md @@ -10,6 +10,12 @@ the Alpine operating system, just like a kind of virtual machine but its not! If you want more help directly [ask for help here](../README.md#help-online-directly). +## Introduction + +TERMUX or ISH are applications providing linux like environment. + +Using Alpine-linux is beneficial for programmers,computer science students, + ## Requirements 1. **IMPORTANT REQUIREMENT** Let's remember that you must have a minimum understanding @@ -85,4 +91,16 @@ A simple `apk upgrade -a` will fix it. * [Ask for help here](../README.md#help-online-directly) * [About Alpine linux](../../alpine/about.md) +# LICENSE + +**CC BY-NC-SA**: this project allows reusers to distribute, remix, adapt, and build upon the material +in any medium or format for noncommercial purposes only, and only so long as attribution is given +to the creators involved. If you remix, adapt, or build upon the material, you must license the modified +material under identical terms, includes the following elements: + +* **BY** – Credit must be given to the creator of each content respectivelly, starting at the first contributor. +* **NC** – Only noncommercial uses of the work are permitted, with exceptions if you fill an issue here! +* **SA** – Adaptations must be shared under the same terms, you must obey this terms and do not change it. + +For more information check the [../alpine/copyright.md](../alpine/copyright.md) diff --git a/tutorials/servers-howto-setup-PXE-service-for-others-linuxes-ES.md b/tutorials/community-way/servers-howto-setup-PXE-service-for-others-linuxes-ES.md similarity index 100% rename from tutorials/servers-howto-setup-PXE-service-for-others-linuxes-ES.md rename to tutorials/community-way/servers-howto-setup-PXE-service-for-others-linuxes-ES.md diff --git a/tutorials/communityway b/tutorials/communityway new file mode 120000 index 0000000..f662c21 --- /dev/null +++ b/tutorials/communityway @@ -0,0 +1 @@ +community-way \ No newline at end of file diff --git a/tutorials/professionalway/server-alpine-gitea-professional.md b/tutorials/professional-way/server-alpine-gitea-professional.md similarity index 100% rename from tutorials/professionalway/server-alpine-gitea-professional.md rename to tutorials/professional-way/server-alpine-gitea-professional.md diff --git a/tutorials/professionalway b/tutorials/professionalway new file mode 120000 index 0000000..479b216 --- /dev/null +++ b/tutorials/professionalway @@ -0,0 +1 @@ +professional-way \ No newline at end of file