4:27 p.m.
To simplify maintaining and editing the documentation I propose we move all
guides to a single repository and a single book on Gitbook.
I did a quick check to see it works here:
https://stianst.gitbooks.io/keycloak-documentation/content/index.html
Opinions?
4:42 p.m.
+1 That is really more convenient !
On Thu, Sep 29, 2016 at 9:27 AM, Stian Thorgersen <sthorger(a)redhat.com>
wrote:
To simplify maintaining and editing the documentation I propose we
move
all guides to a single repository and a single book on Gitbook.
I did a quick check to see it works here: https://stianst.
gitbooks.io/keycloak-documentation/content/index.html
Opinions?
_______________________________________________
keycloak-dev mailing list
keycloak-dev(a)lists.jboss.org
https://lists.jboss.org/mailman/listinfo/keycloak-dev
3:42 p.m.
+1
TBH I am not too keen to the pattern used by many projects, where docs
is spread in multiple different guides. Multiple guides doesn't help
with searching and finding the stuff. You always need to think if the
target content is in guide X or guide Y, which means that usually you
need to try both...
Marek
On 29/09/16 09:42, Sebastien Blanc wrote:
+1 That is really more convenient !
On Thu, Sep 29, 2016 at 9:27 AM, Stian Thorgersen <sthorger(a)redhat.com
<mailto:sthorger@redhat.com>> wrote:
To simplify maintaining and editing the documentation I propose we
move all guides to a single repository and a single book on Gitbook.
I did a quick check to see it works here:
https://stianst.gitbooks.io/keycloak-documentation/content/index.html
<https://stianst.gitbooks.io/keycloak-documentation/content/index.html>
Opinions?
_______________________________________________
keycloak-dev mailing list
keycloak-dev(a)lists.jboss.org <mailto:keycloak-dev@lists.jboss.org>
https://lists.jboss.org/mailman/listinfo/keycloak-dev
<https://lists.jboss.org/mailman/listinfo/keycloak-dev>
_______________________________________________
keycloak-dev mailing list
keycloak-dev(a)lists.jboss.org
https://lists.jboss.org/mailman/listinfo/keycloak-dev
3:55 p.m.
This was a work-around to be able to have a single repository for all docs.
I do agree with you though, it's harder to search and find things when it's
in completely different guides. This ends up being a hybrid approach as all
bits are still separated into the same groupings, but are available from
within the same book so you can search it all. For searching try the
excellent (if I can say so myself) http://www.keycloak.org/search.html -
one search to search them all :)
On 30 September 2016 at 08:42, Marek Posolda <mposolda(a)redhat.com> wrote:
+1
TBH I am not too keen to the pattern used by many projects, where docs is
spread in multiple different guides. Multiple guides doesn't help with
searching and finding the stuff. You always need to think if the target
content is in guide X or guide Y, which means that usually you need to try
both...
Marek
On 29/09/16 09:42, Sebastien Blanc wrote:
+1 That is really more convenient !
On Thu, Sep 29, 2016 at 9:27 AM, Stian Thorgersen <sthorger(a)redhat.com>
wrote:
> To simplify maintaining and editing the documentation I propose we move
> all guides to a single repository and a single book on Gitbook.
>
> I did a quick check to see it works here: https://stianst.gitbooks
> .io/keycloak-documentation/content/index.html
>
> Opinions?
>
> _______________________________________________
> keycloak-dev mailing list
> keycloak-dev(a)lists.jboss.org
> https://lists.jboss.org/mailman/listinfo/keycloak-dev
>
_______________________________________________
keycloak-dev mailing
listkeycloak-dev@lists.jboss.orghttps://lists.jboss.org/mailman/listinfo/keycloak-dev
9:17 p.m.
+1
On 9/30/2016 2:42 AM, Marek Posolda wrote:
+1
TBH I am not too keen to the pattern used by many projects, where docs
is spread in multiple different guides. Multiple guides doesn't help
with searching and finding the stuff. You always need to think if the
target content is in guide X or guide Y, which means that usually you
need to try both...
Marek
On 29/09/16 09:42, Sebastien Blanc wrote:
> +1 That is really more convenient !
>
>
>
> On Thu, Sep 29, 2016 at 9:27 AM, Stian Thorgersen <sthorger(a)redhat.com
> <mailto:sthorger@redhat.com>> wrote:
>
> To simplify maintaining and editing the documentation I propose we
> move all guides to a single repository and a single book on Gitbook.
>
> I did a quick check to see it works here:
> https://stianst.gitbooks.io/keycloak-documentation/content/index.html
> <https://stianst.gitbooks.io/keycloak-documentation/content/index.html>
>
> Opinions?
>
> _______________________________________________
> keycloak-dev mailing list
> keycloak-dev(a)lists.jboss.org <mailto:keycloak-dev@lists.jboss.org>
> https://lists.jboss.org/mailman/listinfo/keycloak-dev
> <https://lists.jboss.org/mailman/listinfo/keycloak-dev>
>
>
>
>
> _______________________________________________
> keycloak-dev mailing list
> keycloak-dev(a)lists.jboss.org
> https://lists.jboss.org/mailman/listinfo/keycloak-dev
_______________________________________________
keycloak-dev mailing list
keycloak-dev(a)lists.jboss.org
https://lists.jboss.org/mailman/listinfo/keycloak-dev
2777
days inactive
2778
days old
4 comments
4 participants
participants (4)
-
Marek Posolda -
Sebastien Blanc -
Stan Silvert -
Stian Thorgersen