Páginas publicadas para documentação?

Estou com dúvidas sobre estas páginas publicadas.
Contexto: Tenho muita documentação no Google Docs. Como parte da mudança da nossa comunidade do Facebook para o Discourse, estamos aproveitando a oportunidade para mover a documentação para o Discourse também.

As pessoas adoravam que a documentação fosse pública e “semelhante ao Word”, imprimiam os arquivos para referência, levavam cópias ao veterinário ou enviavam links por e-mail.

Para mim, a principal vantagem da funcionalidade de Publicação de Página é que ela nos permite tornar público algo que de outra forma teria sido privado. Mas se, como será o meu caso, a documentação já está em uma categoria que será pública, faz sentido publicá-la também?

Os URLs são um pouco mais bonitos. Há menos “móveis do Discourse” na página, o que é bom (mas, por outro lado, exige adicionar um rodapé ou algo para indicar que é um documento da comunidade… não é grande coisa).

Mas onde realmente estou começando a ver um problema é nos muitos links que temos dentro dos documentos que apontam para outros documentos (oba, hipertexto). Se eu usar os URLs de “página publicada”, os membros da comunidade que estão lendo a documentação são retirados da comunidade de certa forma e podem não conseguir encontrar o caminho de volta. Se usarmos os URLs de “tópico do Discourse”, então os leitores externos vão parar em páginas do Discourse, completos com respostas e (no meu caso, pelo menos, talvez eu possa mudar isso?) uma longa lista de novos tópicos não lidos para analisar.

Aqui está um exemplo:

Quem já enfrentou um dilema semelhante? Como vocês resolveram? Existem funcionalidades aqui que poderiam me ajudar, mas que eu talvez não conheça?

Agradeço antecipadamente pela sua opinião.

2 curtidas

Eu não tenho respostas; mas o recurso de publicação de página, embora faça o que foi projetado para fazer, carece profundamente de funcionalidades. Não estou convencido de que este seja o caminho a seguir para o seu propósito :thinking:

3 curtidas

De fato! Você acabou de elucidar o principal caso de uso da publicação de página (tornar conteúdo privado público) - e sua principal limitação (confusão de links e falta de navegação). Basta usar sua categoria pública e estilizar um pouco, se necessário. Você pode achar Discourse Doc Categories útil para navegação.

3 curtidas

Ainda estou um pouco ambivalente. Eu acho que para certos documentos, seria melhor (se a pessoa não estiver conectada ao Discourse) que a barra lateral, os tópicos não lidos e outras coisas estivessem ausentes. Fica mais parecido com um “documento” assim. Haveria uma maneira de exibi-lo assim para usuários que não são do Discourse, mas exibi-lo “com os elementos do Discourse” quando logado? Com a mesma URL?

Haveria soluções para explorar com o WordPress (eu ainda não olhei como eles interagem), mas uma página do WordPress poderia ser “espelhada” no Discourse como um tópico, por exemplo?

2 curtidas

Definitivamente. Dê uma olhada em WP Discourse – WordPress plugin | WordPress.org. Não é oficial, mas há uma categoria para isso: Support > WordPress

Você pode ver isso ao vivo em https://monocycle.info, os artigos são postados automaticamente no fórum https://forum.monocycle.info/c/actualites/47

1 curtida

Aviso de que movi isto para um novo tópico – acho que é valioso.

Devo estar perdendo uma nuance – por que você não pode simplesmente tornar tópicos privados públicos em vez de usar a publicação de páginas? Você poderia usar permalinks se a URL for tão importante. Veja como https://meta.discourse.org/fun redireciona para https://meta.discourse.org/t/discourse-stickers/390126.

1 curtida

Nenhum destes URLs está acessível para mim. Isso é intencional?

1 curtida

Heh, isso foi idiota da minha parte. Eles estão em uma categoria privada. Vou encontrar um exemplo melhor. (Editado.)