By adding to documentation, do you mean the Solr Ref Guide? Or other internal documentation for developers?
If you were thinking of the Solr Ref Guide, Asciidoctor has a plugin asciidoctor-diagram that we could add that would allow us to integrate PlantUML diagrams into pages. The HTML and PDF outputs support it also, so that's great. If this is what you were thinking, file an issue to add it and I'll get it done when I get back from vacation (week after next). As for whether it's useful - the more diagrams we have (in Ref Guide or for some other internal use) the better, IMO. On Fri, Aug 18, 2017 at 3:41 AM, Mano Kovacs <[email protected]> wrote: > Hi, > > As I was preparing a presentation about Solr internals, I tried to > demonstrate some of the internal processes with sequence diagrams. I was > using PlantUML for the purpose as it is opensource, pluggable to everything, > and the markup language is readable, therefore, easy to version it. > > I was wondering if the diagrams would be useful part of the documentation > for those who want to understand internals better. Since the diagrams are > actual text files, it would be possible to store them within the repository > and maintain them among the changes of the internals. It could be also used > for planning new changes, to describe and validate how Solr is going to > behave after a patch. > > What do you think about adding these diagrams into the documentation > somewhere? > > Here are some examples: > > Recovery > Code: https://github.com/manokovacs/solr-internals/blob/master/recovery.puml > Diag: https://github.com/manokovacs/solr-internals/blob/master/recovery.png > > AutoAddReplica > Code: > https://github.com/manokovacs/solr-internals/blob/master/autoaddreplica.puml > Diag: > https://github.com/manokovacs/solr-internals/blob/master/autoaddreplica.png > > Thanks, > Mano > --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
