Portál Fedora Developer vznikl jako podnět od Josefa Střibného a Petr Hráčka. Cílem je dát přehled o důležitých vývojových nástrojích či projektech ve Fedoře začínajícím a pokročilejším uživatelům či vývojářům.
Můžeme si položit otázku, proč mít takový portál? Odpověď je jednoduchá. Abychom usnadnili vývojářům vyvíjet na Fedoře, ať již na Fedora Workstation, Server či Cloud. Proto je potřeba uživatelům ukázat a poradit, jak Fedoru používat pro danou oblast. Čím více bude pokryto oblastí, tím více bude Fedora přívětivá pro uživatele a vývojáře. V neposlední řadě i administrátory.
K čemu by měl portál Fedora Developer sloužit
Portál Fedora Developer má za cíl přiblížit uživatelům Fedoru jak z hlediska vývoje, tak představit
nové věci, které jsou ve Fedoře dostupné. Uživatel Fedory tak bude mít přehled o:
- nových technologiích,
- dostupných vývojových jazycích,
- projektech vydaných v rámci jednotlivých vydáních Fedory,
- důležitých nástrojích Fedory (Docker, Vagrant, DevAssistant apod.),
- nástrojích, které může vývojář používat pro vývoj.
Portál je také určen pro uživatele, kteří by rádi začali či již vyvíjejí aplikace pro Fedoru. Každá sekce, o kterou se uživatel zajímá, poskytuje návod, jak prostředí či systém nastavit pro danou oblast.
Jak portál v současné době vypadá, lze najít na následujícím obrázku či přímo na portálu https://developer-phracek.rhcloud.com/. Jelikož se ale portál vyvíjí, je pravděpodobně, že se ještě graficky změní.
Co skrývá Powerfull Tools ve Fedoře, zjistíme na následujícim obrázku či na adrese https://developer-phracek.rhcloud.com/tools.html.
Jak napsat nový obsah pro specifickou oblast portálu Fedora Developer
Abychom poskytli zájemcům o vývoj ve Fedoře dostatek informací, je potřeba jednotlivé části nejdříve pokrýt vhodným návodem. Jak vytvořit obsah pro určitou oblast je popsáno v této části.
Naklonování obsahu portálu
Obsah portálu je uložen na GitHubu v repositáři https://github.com/developer-portal/content. Je potřeba, aby si člověk, který by rád pokryl určitou oblast, tento repositář forknul a naklonoval. K tomu slouží příkaz:
git clone git@github.com:developer-portal/content.git
Pokrytí specifické části
Každá část musí začít značkou v konfiguračním jazyku YAML, která říká, kam dotyčná část patří. Pro hlavní stránku ruby to je například:
--- title: Ruby page: ruby section: tech-languages
Každá stránka, vyjma hlavní stránky, by měla mít syntaxi:
--- title: Libovolný název page: ruby ---
Následuje samotný obsah napsaný v jazyku MarkDown
Chybějící nepokryté části
Portál Fedora Developer ještě nemá pokryté následující části:
- Nastroje - DevAssistant, Docker, Vagrant
- programovaci jazyky - Python, PHP, Perl, Go, C, NodeJS, Java
- databaze - PostgreSQL, MariaDB, SQLite
- Deployment - Copr, SCL, Nulecule, xdgapp, rolekit, OpenShift
- Fedora Next
Nepokryté části lze také nalézt v sekci issues na GitHubu: https://github.com/developer-portal/content/issues.
Jak poskytnout danou část upstreamu?
Jakmile uživatel pokryje určitou část, je potřeba ji dát na GitHub a následně pomocí tzv. Pull Requestu
poslat vývojářům portálu ke kontrole. Ti případně pošlou zpět nápady ke zlepšení.
Pokud by se někdo rozhodl pokrýt určitou oblast, pak je zde zajímavé ocenění věnované firmou RedHat. Uživatel, který napíše obsah, jež bude schválen pro portál, bude mít možnost získat "Red Hat Cool stuff" jako kšiltovku, hrníček, apod.
Příklad části o ruby
Jako příklad můžeme uvést část pro Ruby, která je již připravena na portálu https://github.com/developer-portal/content/tree/master/languages/ruby.
Testovací instance na OpenShiftu
Portál je prozatím hostován zde: http://developer.fedorainfracloud.org/, neboť ještě není oficiálně zveřejněn, jak bylo zmíněno výše. Pro snazší orientaci by měl být odkaz na Fedora Developer Portal umístěn přímo na http://getfedora.org.
Na tomto místě bych rád poděkoval Adamu Šamalíkovi, který je spoluautorem portálu Fedora Developer.
Odkazy:
- https://github.com/developer-portal/content
- https://fedoraproject.org/wiki/Websites/Developer
- https://developer-phracek.rhcloud.com/
- https://en.wikipedia.org/wiki/Markdown
- http://blog.samalik.com/fedora-developer-portal/
- http://blog.samalik.com/fedora-developer-portal-prototype/
- http://taiga.cloud.fedoraproject.org/project/fedora-developer-portal/kanban
28. 7. 2015 at 12:14
To je perfektní aktivita, děkuju!
28. 7. 2015 at 16:14
Zapomnel jsem zminit, ze jakekoliv otazky ci temata o developer-portalu mohou uzivatele probirat na freenode IRC serveru a konkretne na kanalu #developer-portal
29. 7. 2015 at 16:02
Odkaz na část o ruby je nefunkční (404). Jinak zajímavý projekt, zkusím se zapojit 🙂
12. 8. 2015 at 14:49
ODkaz uz je funkcni
4. 8. 2015 at 15:17
Predtim nez budete klonovat repositar je potreba jej „forknout“. Opomenuti s me strany. Jinak nepujde udelat Pull Request.
10. 9. 2015 at 16:13
Misto developer-phracek.rhcloud.com nyni vyuzivame cloudovou instanci http://developer.fedorainfracloud.org/
12. 9. 2015 at 01:31
Odkaz v článku jsem opravil.