All,
We currently have some existing documentation written and still being
worked on. It can be found at
https://github.com/RITlug/TigerOS/wiki. Much
of this documentation is specific to TigerOS and may or may not be useful
to the wider Fedora community. If however there are things that you would
find useful, please let me know and we can edit or update them as necessary
to be useful to both projects. As far as a list, I was able to brainstorm
some challenges that the team faced in the course of developing TigerOS
that may have solutions in documentation. I have included the list below.
mock failing
koji not scaleable to small projects. Much of the details of how to set it
up confusing
RPM docs not centralized
GRUB and anaconda installclass
no established procedure for replicating Fedora build system
not sure who to ask about how fedora does building, how fedora handles
signing keys, etc. no sense of who to ask what
automating builds biggest issue...
This is a very rough list so it may be missing things. Please let me know
if anything is unclear. I have also copied the rest of the TigerOS team on
this email so that we are all on the same page.
Thank you.
Sincerely
Aidan Kahrs
abkahrs(a)fedoraproject.org
On Thu, Mar 29, 2018 at 1:32 PM, Justin W. Flory <jflory7(a)gmail.com> wrote:
On 03/26/2018 05:48 PM, Aidan Kahrs wrote:
> Hello,
> I would like to start the conversation about what we might be able to
> contribute to Fedora that will be mutually beneficial for both projects.
> For the last year or so, I have been the lead of a project to develop a
> Fedora remix and in this process the team and I have learned many things
> we feel may be useful to the upstream Fedora community. We have created
> our own custom RPM packages, are in the process of automating our build
> infrastructure(not using Koji as it is too large scale for us), and have
> setup an RPM and ISO download mirror. Much of this process was fumbling
> around in the dark trying to find the right way to do it. I have
> included a number of links to various resources about the remix below.
>
> Please let me know if there is interest in this. The team and I would be
> glad to work with you.
>
> TigerOS
> ------------
> Website:
https://tigeros.ritlug.com
>
> GitHub:
https://github.com/RITlug/TigerOS
> <
https://github.com/RITlug/TigerOS>
>
> #rit-tigeros on
irc.freenode.net <
http://irc.freenode.net>
>
Hi Aidan!
As I understand it, you want to contribute new, original documentation
specific to creating a Fedora Remix or derivative work based on upstream
Fedora.
I see this as helpful and useful to include in upstream Fedora; however,
I am unable to answer where this type of content should live.
Do you have any existing documentation already written as a reference?
If so, it is helpful to see what you have so far. If not, do you have a
bullet-point list of topics you could share, to help us understand what
topics you want to cover? This helps us understand where your topics
could fit in the new system.
In the meanwhile, check out AsciiDoc. AsciiDoc is the markup language we
use for our documentation. Until you get an answer on where this
belongs, you and the TigerOS community can work on writing documentation
in AsciiDoc. This will make it easier to "plug in" to the right place,
once we know where it belongs.
https://asciidoctor.org/docs/asciidoc-syntax-quick-reference/
https://asciidoctor.org/docs/asciidoc-recommended-practices/
Check out examples here for how we are doing docs now:
https://pagure.io/fedora-docs/quick-docs
Do you have any questions for us?
--
Cheers,
Justin W. Flory
jflory7(a)gmail.com