[Fedora-electronic-lab] Dead Upstream what should we do ?

[Chitlesh GOORAH]

On Sat, Oct 31, 2009 at 9:38 PM, Shakthi Kannan wrote:
> For the wiki:
> * CSS work is required to motivate people to use it, and put
> project/tools documentation.

Which CSS work ? You mean theme trac ? If you have a theme in mind, we
can package it and ask Fedora Infrastructure to set it up.

> * The documentation should be made usable offline, by exporting it to
> pdf or some other format.

Yes this has been an issue for quite a long time now.

This is my opinion but I would certainly like to hear yours.

There is upstream documentation and FEL specific documentation. Our
objective should be to have less FEL specific documentation and
migrate any documentation to their upstream sources.

That said, upstream documentation should be a manpage, tutorials and
examples. These go to %doc in the FEL packaging.

FEL specific documentation should be where to find the examples,
whether docs are in main package or -doc package, which variable which
needs to set up and how interoperability between tools of different
upstream work. I was thinking of a yelp based help similar to the
gnome help.
It is fairly easy to write a script to create such a yelp
infrastructure. The latter will then be called directly from the
Electronics menu on the gnome menu.

I've drafted a piece here,
https://fedorahosted.org/fedora-electronic-lab/browser/documentation

As for the upstream documentation, if someone finds a tutorial (not
from upstream) about a tool we need to contact upstream to put it
among the sources. Another question comes up. Wouldn't it be nice to
have a similar latex template of all EDA software ?

> Or, if we want to use LaTeX for all our documentation, we will need to
> revision its sources, and make .pdf versions available for users to
> download and use.

Here we can use the fel git repo. I've already all the versions of FEL
flyer and release notes sources there.

> The following needs to be completed for it?
>
> https://fedorahosted.org/fedora-electronic-lab/ticket/25

I'm reviewing a nice application
https://bugzilla.redhat.com/show_bug.cgi?id=526844

>
> For the ticket-based system:
> * Some nice CSS changes will be helpful.

I'm not a CSS expert. I can't help you there. However we can propose
mockups to the Fedora Websites team to create CSS for us. If you have
something in mind please propose :)

Actually other Fedora spins consider FEL as a model, so please propose
your ideas :)

Chitlesh