About & Roadmap

[frenetic]

Ativei o wiki deste projeto.
Nele criei duas páginas: Home e About.

A home não tem anda de útil, mas vale a pena revisarem e melhorarem.

O foco deve ser a página de about.
Nela eu falo melhor sobre o projeto, sobre as features do projeto, e tento descrever, mais ou menos, como é o roadmap para o lançamento de versões.

@igr-santos - Você, como dono do projeto e idealizador da ideia, dá uma revisada lá.
Ve se está tudo de acordo com o que você pensou para o projeto.
O escopo lá ficou bem aberto para que tu possas injetar as tuas ideias.

[luzfcb]

Sugestões: integrar com ipython-notebook e/ou com o https://trinket.io/

[igr-santos]

Sensacional @frenetic, mais tarde vou ler com carinho :D

@raphapassini e @luzfcb deem uma olhada também.

[igr-santos]

@luzfcb abre um issue e implementa isso pra galera 👍

[frenetic]

@luzfcb @igr-santos Abre uma issue e encaixa isso no roadmap...
Vamos programar saporra organizado, e com testes.

[igr-santos]

@frenetic @luzfcb galera, eu, o @raphapassini e o @vierno, descobrimos uma outra forma de fazer, uma forma mais simples, iremos utilizar o pull-request e fork como é feito, apenas iremos utilizar a interface de administração do conteúdo pelo pypress.

A intenção é que o pypress administre o conteúdo e apresente-o de forma mais simples possível, e que o github faça todo o review dos textos como já é feito hoje, iremos interferir na forma em que o conteúdo poderá ser escrito, queremos que mais de uma pessoa possa contribuir com o mesmo texto, é isso que estamos buscando fazer nessa interface.

Aguardo sugestões!
Se quiserem estudar como funciona a API GitHub seria muito interessante, vou começar a ler sobre aqui.

[raphapassini]

Em linhas gerais o workflow seria o seguinte:

• O autor se autentica com o seu github
• O pypress verifica se o autor já possui um fork do repositório[1] caso o usuário não tenha um fork, nós vamos fazer isso para ele automaticamente[2]
• O autor então vai ter acesso a uma interface onde ele vai poder ver os textos que estão sendo escritos nesse momento, a ideia seria listar os forks existentes, pegar os arquivos da pasta content de cada fork e fazer uma comparação com o que está no branch master do pythonclub exibindo assim os textos que ainda não estão publicados ( vamos considerar como publicados os textos que estão no repositório master do Pythonclub)
• Vamos fornecer um link direto para edição e colaboração naquele texto, o link seria da própria edição dentro do github. Aqui temos já nosso primeiro problema, se o usuário A já possui um fork e o usuário B cria um texto novo o github vai apresentar uma mensagem de erro quando você tentar propor sua mudança no arquivo, pois, você não tem o arquivo do usuário B no fork do usuário A, de alguma maneira vamos precisar fazer um merge entre os forks do usuário A e usuário B, mas eu não achei isso na API ainda.
• O autor pode criar novos textos vamos simplesmente abrir a interface do github para ele editar diretamente lá e o que podemos fazer é um botão na interface chamado "Solicitar publicação" e a gente gera um pull-request automático do fork do autor para o master do pythonclub.

Em linhas gerais é isso ai, alguém tem um fluxo melhor ou pensa diferente? Será que estamos viajando para resolver uma coisa simples que é - colaboração entre usuários!?

[1] https://developer.github.com/v3/repos/forks/
[2] https://developer.github.com/v3/repos/forks/#create-a-fork

[luzfcb]

blog com ideia similar, no quesito facilidade, escrito em Django
https://github.com/gkmngrgn/radpress