From 22252e3df474dc2d7d380981290567e873d8b701 Mon Sep 17 00:00:00 2001 From: mckaygerhard Date: Mon, 1 Aug 2022 15:36:26 +0000 Subject: [PATCH] tutorials - fix links and organize better * fix links over licensing --- alpinelinuxtermux.md | 7 --- newbie/started.md | 36 -------------- tutorials/README.md | 28 ++++++----- tutorials/community-way/README.md | 13 ++++- .../alpine-tutorial-in-phones.md | 2 +- tutorials/professional-way/README.md | 48 +++++++++++++++++++ 6 files changed, 77 insertions(+), 57 deletions(-) delete mode 100644 alpinelinuxtermux.md delete mode 100644 newbie/started.md create mode 100644 tutorials/professional-way/README.md diff --git a/alpinelinuxtermux.md b/alpinelinuxtermux.md deleted file mode 100644 index 113baf4..0000000 --- a/alpinelinuxtermux.md +++ /dev/null @@ -1,7 +0,0 @@ -TERMUX is appliction providing linux like environment. - -ALPINE-LINUX is fast,small and secure kind of distro of linux. -Using Alpine-linux is beneficial for programmers,computer science students,normal people, and also students of different disciplines. -Also learning alpinelinux in phone is easy for people not having pc,laptop or such requirement and also for those who don't have linux in their PCs. - -alpinelinuxtermux wiki is created which will be beneficial for using it in termux. diff --git a/newbie/started.md b/newbie/started.md deleted file mode 100644 index f67c238..0000000 --- a/newbie/started.md +++ /dev/null @@ -1,36 +0,0 @@ - -.. firs of all.. when you start to learn something you should check your available resources agains the needs .. - -## requirements - -We are persons, so first of all [we have real life requirements](#real-life-requirements) -and after [we need related requirements](#related-requirements). - -You as future contributor or developer must check your resources and adapt those to your situation.. -that seems unrelated to learning but ITS VERY IMPORTANT! Why?: well cos in linux and development -you shoul READ A LOT .. and that will waste time from your life. - -### Real life requirementes - -* **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 similar, by example most of the people uses the androit phone to handle an internal linux using [termux](termux-pending-file.md) - -### Related requirementes - -* **Knowledge** you will need a knowed editor, a god knowledge of git as minimal base.. -* **Internet**, and minimal bandwitch of internet network.. cos almost today all the development will forced to you to contribute over internet. -* **Unix-like**, you should have some kind of way to interact with a UNIX like operating system, like MAC or Linux. - -### About this wiki newbie - -This material is a main one, for a more focused tutorial please check -the [../tutorials/](../tutorials/) directory space, that have more focused or maybe simple ways to -reach specific objetives. Of course those **guides or tutorials will assume you already have knowledge**. - -On the other hand, **this material (newbie sections) assumes a more general level and helps you to follow the steps more slowly, -in categories and explained steps**. - -### About copyright material - -Please check our [../alpine/copyright.md](../alpine/copyright.md). diff --git a/tutorials/README.md b/tutorials/README.md index d01299e..e66a020 100644 --- a/tutorials/README.md +++ b/tutorials/README.md @@ -1,9 +1,24 @@ Alpine Linux tutorias and how tos ================================= -This category section will try to guide new ones with almost basic enought knowledge of Linux. +The **tutorials are hands-on docs** expected to try and achieve the goals described +in each step, possibly with the help of a good example. The output in one step +is the starting point for the following steps. -**CONSIDERATIONS**: Please check the [Feature Differences OF THIS ALPINE LINUX](../newbies/README.md#feature-differences) +The **Howtos are smaller articles** explaining how to perform a particular task +with Alpine Linux, that expects a minimal knowledge from reader to perform actions. + +## TUTORIALS AND HOW TOS + +We divided the guides, tutorials and howtos in 3 main sections (directories): + +1. [newbies](../newbies) (formal ways of doing things but with explanations, mostly for begginers) +2. [community-way](community-way) (informal ways of doing things, with minimal or no explanations) +3. [professional-way](professional-way) (informal ways but with more explanations and implicit security) + +## Acknowledges + +**CONSIDERATIONS**: Please check the [Feature Differences OF 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**. @@ -19,15 +34,6 @@ but you can use linux using [termux](tutorial-alpine-in-phone.md) or [ish](tutor * **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 - 🗯 IRC diff --git a/tutorials/community-way/README.md b/tutorials/community-way/README.md index cbb22b5..a094a2e 100644 --- a/tutorials/community-way/README.md +++ b/tutorials/community-way/README.md @@ -1,11 +1,20 @@ Community way of alpine wiki documentation ========================================= +The **tutorials are hands-on docs** expected to try and achieve the goals described +in each step, possibly with the help of a good example. The output in one step +is the starting point for the following steps. + +The **Howtos are smaller articles** explaining how to perform a particular task +with Alpine Linux, that expects a minimal knowledge from reader to perform actions. + 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) +For more up to date documents check [the main index at tutorials/README.md](../README.md) ## INSTALL +TODO + ## PHONES * [alpine-tutorial-in-phones.md](alpine-tutorial-in-phones.md) @@ -61,5 +70,5 @@ material under identical terms, includes the following elements: * **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) +For more information check the [../../alpine/copyright.md](../../alpine/copyright.md) diff --git a/tutorials/community-way/alpine-tutorial-in-phones.md b/tutorials/community-way/alpine-tutorial-in-phones.md index f767cf5..023ae15 100644 --- a/tutorials/community-way/alpine-tutorial-in-phones.md +++ b/tutorials/community-way/alpine-tutorial-in-phones.md @@ -102,5 +102,5 @@ material under identical terms, includes the following elements: * **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) +For more information check the [../../alpine/copyright.md](../../alpine/copyright.md) diff --git a/tutorials/professional-way/README.md b/tutorials/professional-way/README.md new file mode 100644 index 0000000..3fffb3d --- /dev/null +++ b/tutorials/professional-way/README.md @@ -0,0 +1,48 @@ +Alpine wiki in Professional ways +================================ + +The documentation here requires a minimum medium or advanced level of knowledge in Linux, +if you do not have the level it is recommended that you read the [documents in the NEWBIE category](../../newbie/README.md) + +## SERVICES + +* [server-alpine-gitea-professional.md](server-alpine-gitea-professional.md) + +## 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) +