Documentação e website

[claudiosanches]

Esta na hora de documentar e ter um website de verdade.

Podemos fazer isso usando o WordPress mesmo, hospedando em algum lugar, ou podemos hospedar no GitHub o site e usar a Wiki que já temos.

Também podemos hospedar no GitHub e fazer um blog/documentação em HTML estático. Para fazer isso da para usar o Jeckyll ou Octopress.

Bom, para quem não sabe o Jeckyll serve para desenvolver blogs usando o GitHub Pages. O Octopress é um sistema um pouco mais treta que faz isso também, mas com suporte de temas, plugins já prontos e etc. Gostei pra caramba dele xD

Documentação do Octopress: http://octopress.org/

Octopress é bem legal, tem gente até migrando do WordPress e usando ele. Todos os posts e páginas são escritos em Markdown e o Octopress converte para HTML, instala temas, configura plugins e fazer deploy pro GitHub xD. E essa é a vantagem, HTML estático, leve, limpo e hospedado de graça no GitHub.

Enfim, podemos usar ele para gerar a nossa documentação. No caso vamos precisar trocar o /blog por /docs e ai esta tudo ok...

Qual a vantagem de usar o Octopress no lugar de WordPress? Vantagem seria ter ele hospedado gratuitamente no GitHub Pages e também que qualquer um do grupo vai poder atualizar ele usando GIT, em vez de distribuir usuário e senha para 100 pessoas xD (além que com GiT, podemos ver o que foi atualizado e por quem).

Vantagem do WordPress eu nem preciso falar né? Todo mundo aqui usa xD

Enfim as opções são:

1. Criar um site em WordPress e documentar nele.
2. Criar um site em WordPress e usar a Wiki do GitHub como documentação.
3. Criar um site no GitHub Pages com Octopress e usar a Wiki do GitHub como documentação.
4. Criar um site no GitHub Pages com Octopress e documentar nele.

[RafaelFunchal]

isso aí, @deblyn .

Temos que ver também quais são as classes mais importantes do BuddyPress e do bbPress para já deixá-las previstas no sass.

[deblynprado]

Então, eu montei um briefing sobre o Odin e coloquei lá no grupo. https://www.facebook.com/groups/wordpress.brasil/doc/543989458978363/

O que vocês precisariam agora? Querem rascunhar um Wireframe pra galera discutir ou até votar no grupo e a partir daí inicia-se o processo de criação?

Ah, e uma outra Page-Template interessante pode ser a de Shop com o WooCommerce =D

Quanto ao bbPress e BuddyPress @rafaelfunchal eu nunca usei nenhum dos dois, mas também acho importante deixar as classes listadas no SASS. Assim se o cara quiser ele tira o comentário e gera o arquivo ;)

[ruanbarbosa]

Pessoal, estava desenvolvendo este layout aqui em um projeto: https://www.dropbox.com/s/vr2tyukzz8kmzq0/layout-tema.jpg

Ainda está meio cru, mas se quiserem, posso adaptá-lo com a ajuda de vocês para o Odin.

[claudiosanches]

Esse layout esta bonito, mas acho que tem muita coisa, precisamos para montar o framework menos coisas ainda, se mais limpo xD

[RafaelFunchal]

E se partirmos de algo assim? http://designmodo.github.io/Flat-UI/

[ruanbarbosa]

gostei @rafaelfunchal! @claudiosmweb é, esse tem algumas "firulas" a mais haha

[claudiosanches]

@rafaelfunchal nessa pecada mesmo.

[deblynprado]

Pô achei bem bacana hein @rafaelfunchal ele só não é responsivo.

Mas gostei da pegada dele. Bem simples e com uns efeitinhos bem bacanas.

Vou ver se consigo fazer um Wireframe pelo menos de uma home seguindo essa linha mais ou menos dele... Se você quiser rascunhar algo também @rafaelfunchal faz e disponibilizamos pra galera...

[deblynprado]

Pessoal,

acho que deveríamos fazer um estudo de caso dos nossos principais concorrentes pra poder montar o layout. Estou tentando alguma coisa no Balsamiq mas confesso que estou na dúvida quanto a alguns pontos...

Eu particurlamente gosto muito do header usado pelo bootstrap e foundation com aquele menu fixo no topo, um descrição o opção de download.

Não sei se seria o ideal para nós, mas acho que é uma boa opção. Quais são os principais concorrentes que vocês conhecem?

Até agora olhei o _s, Foundation e bootstrap.

[deblynprado]

Uma coisa, não seria melhor ter as fontes definidas com 'em' ao invés de px?

Assim dá menos trabalho na hora de alterar o tamanho.

[claudiosanches]

Seria uma boa xD

[RafaelFunchal]

Quanto mais eu penso nesse projeto mais me dá vontade de usar o Twitter Bootstrap. Não acham que estamos tentando reinventar a roda nesse caso?

[deblynprado]

@rafaelfunchal por ser um framework talvez tenhamos essa impressão.

Eu a princípio acho que não.

[claudiosanches]

Problema de usar o Twitter Bootstrap é que nele tem muito mais coisas que vamos usar xD Vamos acabar forkando ele e nunca mais voltando atrás, mas daria para fazer isso. Se a Locaweb fez nos podemos também :P

[adammacias]

Concordo com você @rafaelfunchal, faz um bom tempo que adotei o Bootstrap como meu framework padrão para frontend. A versão 3 promete ter muitas novidades: https://github.com/twitter/bootstrap/pull/6342

@claudiosmweb acho que a Locaweb fez certo, mas sei lá, não gostei do UI deles =P

[claudiosanches]

Por mim pode adotar o bootstrap, é de boa. Tem LESS oficial e SASS, além que já é documentado e já era xD.

O que vocês acham?

[deblynprado]

Eu particularmente não queria pegar... acho que seria mais jogo fazermos o nosso.

Mas se a maioria quiser beleza! Vamo que vamo! :)

[claudiosanches]

Por mim tanto faz, eu sou um cara bem de boa quanto a padrões, adoto qualquer um em poucos minutos xD

[ruanbarbosa]

Eu sou mais da opinião do @deblynprado, mas se acharem que é necessário... Não é possível desenvolver alguns módulos? Por exemplo, que tenha a opção de adotar o bootstrap, um próprio e outros que poderão ser adicionados com o tempo. Desculpa se falei bobagem.

[deblynprado]

Eu cheguei a pensar em ter as 2 opções...

Uma para o Bootstrap e outra com o nosso framework.

Resta saber no fim das contas qual seria o melhor pro usuário final...

[claudiosanches]

Se o usar o Bootstrap vamos precisar documentar menos xD

[vitorbritto]

Então pessoal, eu comecei a desenvolver um framework para utilizar nos meus projetos. Reuni o Bootstrap, Foundation, Bourbon e Neat para ter algo que ajudasse no meu workflow. Semana passada dei início aos testes de integração com grunt, composer e bower, mas precisei estacionar por conta de alguns projetos que entraram na minha pauta.

Ia conversar até com o @claudiosmweb para agregar o framework que estou desenvolvendo ao Odin. E, eu estou querendo agregar o Odin ao meu framework (já que trabalho muito com o WordPress). Porém, o que consegui fazer até o momento foi:

• Organizar a estrutura do Framework
• Escrever parte da documentação
• Deixá-lo com "versões" para uso com o Bootstrap, Foundation, Compass + Susy ou Bourbon + Neat

Como o Odin já possui grid, integração com o grunt e estrutura pronta, acho que seria mais prático criar um UI Kit, componentes JS e ir documentando.

Estou compartilhando, pois acho interessante que o Odin tenha a sua própria identidade visual. Mas, nada impede que seja baseado em algum framework já existente. =]

Abs!

[claudiosanches]

Legal isso @vitorbritto.

Então, dava para desenvolver uma identidade, entretanto no momento anda foda, eu não tenho tempo para fazer design e nada saiu até o agora xD

Acho que daria para aproveitar o resto dessa moda ai e usar o Bootstrap mesmo, depois podemos numa versão no futuro criar algo novo.

[deblynprado]

É cara, eu olhei com muito carinho o bootstrap hoje e repensando no tempo que estamos levando e a quantidade de coisa que tem pra fazer acho que o bootstrap é hoje a melhor solução.

Pode ser que no futuro venhamos a mudar de ideia, mas adotar o bootstrap agora vai nos adiantar absurdamente!

[vitorbritto]

Entendo perfeitamente, pessoal. Então, vamos em frente! =]

[claudiosanches]

Então, vou adicionar o https://github.com/jlong/sass-twitter-bootstrap.

Vou também criar um Gruntfile separado ou até mesmo algo em Python ou SH para rodar e atualizar isso dai e as outras coisas que estamos usando de JS e etc. Porque se não vai ficar foda para atualizar.

Com o Bootstrap ai da para criar os shortcodes numa boa e fazer o resto do layout.

O que os senhores acham?

[deblynprado]

É, tem que deixar bem modular. Inclusive pra poder atualizar tanto nosso core quanto o bootstrap sem quebras.

Meu maior medo nessa adoção é daqui a um tempo ficar bizzarro pra fazer os updates.

[claudiosanches]

Acabei de fazer um script com grunt que resolve tudo xD

[RafaelFunchal]

@claudiosmweb O homem que nunca adormece!

[claudiosanches]

Twitter Bootstrap adicionado #63

[fdaciuk]

Meu.. a task do Bootstrap ficou muito loka! Parabéns @claudiosmweb! xD

[deblynprado]

Caraleeeoooo =D

vou ver aqui como ficou!

Valeu @claudiosmweb

[willmkt]

Galera de uma olhada nesse framework http://www.adamantium-wp.com.ar/ eu ja usei ele em varios projetos, da para usar algumas ideias dele..

[claudiosanches]

Nossa nojento esse admantium, tem umas coisas muito zuadas, pra começar a arvore do repo dele xD Jogando coisas fora do tema, mas quando rolar tempo vou tentar ler o código e ver se tem umas coisas boas ai nele.

[claudiosanches]

Aff, ficando com nojo: https://github.com/alandawi/adamantium-starter-kit/blob/master/wp-content/themes/adamantium/header.php#L49 https://github.com/alandawi/adamantium-starter-kit/blob/master/wp-content/themes/adamantium/404.php

Campeão o cara.

[RafaelFunchal]

Não curti também. Unstar!

[claudiosanches]

Só gostei disso: https://github.com/alandawi/adamantium-starter-kit/blob/master/wp-content/themes/adamantium/includes/adamantium.php#L78

Talvez seria legal ou não... Colocar essas coisas de remover o nome do autor do id nos comentários, esconder os erros de login (mas no caso retornar uma mesma mensagem padrão para todos), também de deixar algo pronto para usuário assinante não ter acesso ao administrador do site e só xD

[RafaelFunchal]

Oi, @deblynprado (só para não passar na frente de ninguém e ter retrabalho), conseguiu fazer algum wireframe?

Estou pensando em mexer direto em uma instalação minha aqui e já ir alterando :)

Ah, tem que atualizar a versão que está no http://odin-theme.web817.uni5.net/

[deblynprado]

Ué! Eu jurava que já tinha postado isso aqui...

http://imageshack.us/a/img833/650/indexud.png

tá aí o link @rafaelfunchal

Vou atualizar a versão lá ;)

[RafaelFunchal]

Valeu :+1:

[deblynprado]

Tava pensando em abrir um repo pra colocar os editáveis, PSD's e etc do layout...

acha válido?

[claudiosanches]

Acho que nem vai precisar.

[deblynprado]

Tranquilo então...

Vê o que vocês acham dessa index aí... já tá montada com o Grid do Bootstrap

[RafaelFunchal]

Eu curti

[claudiosanches]

Pra documentação isso vai ser apenas um front-page.php xD Mas acho que seria legal ter um repo pro site da documentação. No caso vai ser um tema filho, com o que temos direto na documentação apenas. E ai vale deixar o wireframe nela.

O que vocês acham?

[deblynprado]

É, eu pensei em fazer wireframe do tema todo e deixar disponibilizado tanto o editável quanto a imagem pra nego poder usar à vontade depois.

O lance do repositório seria uma boa, daí podia ter tudo isso com os psd's finais e tal... já facilita até pro candango que for criar um layout em cima o Odin

[RafaelFunchal]

Preferem criar um branch design para irmos tramando ou faremos isso direto no master?

A idéia do repo para o tema filho é bacana.

[RafaelFunchal]

Maldito corretor: trampando

[deblynprado]

Mas aí esse branch não teria pull pro master nunca né?

Se for isso é melhor fazer no master do repo filho....

[RafaelFunchal]

Eu estava pensando em ter alguns templates de página prontos no Odin mesmo. Aí o cara só seleciona nas opções da página.

Pensei em ter esse wireframe como um template page do Odin já.

O tema filho a gente pira a vontade.