Software Público Brasileiro

Olá pessoal,

Na experiência de vocês em projetos de software livre, o README está associado ao projeto ou à módulos específicos? Por exemplo, o CACIC é composto de um servidor (windows), um cliente windows e um cliente linux. Nesse caso normalmente seriam 1 ou 3 READMEs?

No beta, o link Manuais de cada software aponta para uma pasta específica dentro do repositório?

Obrigado,

Rodrigo Maia
www.rodmaia.net

On Thu, Jan 15, 2015 at 10:30:58AM -0500, Rodrigo Maia wrote:

> Olá pessoal,
>
> Na experiência de vocês em projetos de software livre, o README está
> associado ao projeto ou à módulos específicos? Por exemplo, o CACIC é
> composto de um servidor (windows), um cliente windows e um cliente
> linux. Nesse caso normalmente seriam 1 ou 3 READMEs?

Depende. se cada módulo for um repositório separado, normalmente vai ter
um README pra cada um.

> No beta, o link Manuais de cada software aponta para uma pasta
> específica dentro do repositório?

Não tenho idéia sobre isso.

--
Antonio Terceiro
http://softwarelivre.org/terceiro

> Depende. se cada módulo for um repositório separado, normalmente vai ter
> um README pra cada um.

Então varia de projeto pra projeto?

Rodrigo Maia
www.rodmaia.net

> Em 15/01/2015, à(s) 1:06PM, Antonio Terceiro escreveu:
>
> On Thu, Jan 15, 2015 at 10:30:58AM -0500, Rodrigo Maia wrote:
>> Olá pessoal,
>>
>> Na experiência de vocês em projetos de software livre, o README está
>> associado ao projeto ou à módulos específicos? Por exemplo, o CACIC é
>> composto de um servidor (windows), um cliente windows e um cliente
>> linux. Nesse caso normalmente seriam 1 ou 3 READMEs?
>
> Depende. se cada módulo for um repositório separado, normalmente vai ter
> um README pra cada um.
>
>> No beta, o link Manuais de cada software aponta para uma pasta
>> específica dentro do repositório?
>
> Não tenho idéia sobre isso.
>
> --
> Antonio Terceiro
>http://softwarelivre.org/terceiro
>
>
> _______________________________________________
> spb-dev mailing list
> spb-dev@listas.softwarepublico.gov.br
>http://listas.softwarepublico.gov.br/mailman/cgi-bin/listinfo/spb-dev

Em 15 de janeiro de 2015 16:06, Antonio Terceiro

> escreveu:

> On Thu, Jan 15, 2015 at 10:30:58AM -0500, Rodrigo Maia wrote:
> > Olá pessoal,
> >
> > Na experiência de vocês em projetos de software livre, o README está
> > associado ao projeto ou à módulos específicos? Por exemplo, o CACIC é
> > composto de um servidor (windows), um cliente windows e um cliente
> > linux. Nesse caso normalmente seriam 1 ou 3 READMEs?
>
> Depende. se cada módulo for um repositório separado, normalmente vai ter
> um README pra cada um.
>

No caso do CACIC, seria um README para cada módulo.

> > No beta, o link Manuais de cada software aponta para uma pasta
> > específica dentro do repositório?
>
> Não tenho idéia sobre isso.
>

No SPB, a tendência é que os manuais fiquem no Noosfero mesmo. Na
comunidade de software livre ele tendem a manter no raiz do repositório.

--
Paulo Meirelles
FGA-UnB (http://fga.unb.br)
CCSL-IME/USP (http://ccsl.ime.usp.br)

Em 15 de janeiro de 2015 16:40, Rodrigo Maia escreveu:

> Depende. se cada módulo for um repositório separado, normalmente vai ter
> um README pra cada um.
>
>
> Então varia de projeto pra projeto?
>

Nas comunidades de software livre um pouco mais maduras, cada repositório
tem um README.

--

Paulo Meirelles
FGA-UnB (http://fga.unb.br)
CCSL-IME/USP (http://ccsl.ime.usp.br)

Sobre o README: entendido. :)

Sobre os manuais, o Urbem direciona para cá: https://beta.softwarepublico.gov.br/social/urbem/manuais-de-usuario . O que não me parece ser o GitLab. Então a pergunta era mais no sentido de saber vale mais à pena de criar uma página para os manuais assim como existe para “Como instalar”.

Obrigado,

Rodrigo Maia
www.rodmaia.net

> Em 15/01/2015, à(s) 1:59PM, Paulo Meirelles escreveu:
>
> Em 15 de janeiro de 2015 16:06, Antonio Terceiro > escreveu:
> On Thu, Jan 15, 2015 at 10:30:58AM -0500, Rodrigo Maia wrote:
> > Olá pessoal,
> >
> > Na experiência de vocês em projetos de software livre, o README está
> > associado ao projeto ou à módulos específicos? Por exemplo, o CACIC é
> > composto de um servidor (windows), um cliente windows e um cliente
> > linux. Nesse caso normalmente seriam 1 ou 3 READMEs?
>
> Depende. se cada módulo for um repositório separado, normalmente vai ter
> um README pra cada um.
>
> No caso do CACIC, seria um README para cada módulo.
>
> > No beta, o link Manuais de cada software aponta para uma pasta
> > específica dentro do repositório?
>
> Não tenho idéia sobre isso.
>
> No SPB, a tendência é que os manuais fiquem no Noosfero mesmo. Na comunidade de software livre ele tendem a manter no raiz do repositório.
>
> --
> Paulo Meirelles
> FGA-UnB (http://fga.unb.br )
> CCSL-IME/USP (http://ccsl.ime.usp.br )
> _______________________________________________
> spb-dev mailing list
> spb-dev@listas.softwarepublico.gov.br
>http://listas.softwarepublico.gov.br/mailman/cgi-bin/listinfo/spb-dev

Em 15 de janeiro de 2015 20:25, Rodrigo Maia escreveu:

> Sobre o README: entendido. :)
>
> Sobre os manuais, o Urbem direciona para cá:
>https://beta.softwarepublico.gov.br/social/urbem/manuais-de-usuario. O
> que não me parece ser o GitLab. Então a pergunta era mais no sentido de
> saber vale mais à pena de criar uma página para os manuais assim como
> existe para “Como instalar”.
>

Sim, no contexto do SPB, vale mais a pena criar uma página no "social".
Como falei, a tendência é que eles criem esses conteúdos no Noosfero mesmo.

--

Paulo Meirelles
FGA-UnB (http://fga.unb.br)
CCSL-IME/USP (http://ccsl.ime.usp.br)