Create a “Who's Using Asciidoctor?” page

graphitefriction commented 10 years ago

O’Reilly and MakerPress
Clojure Cookbook
GitHub supports AsciiDoc syntax in repositories, wikis and gists (powered by Asciidoctor)
NFJS, the Magazine is produced from articles written in AsciiDoc
Context and Dependency Injection for the Java EE Platform (CDI)
- Specification
- Website
Golo Programming Language Guide (AsciiDoc Python, soon to be Asciidoctor!)
Neo4j graph database project (AsciiDoc Python, soon to be Asciidoctor!)
Phusion Passenger Users Guides (AsciiDoc Python)
Git user manual (Asciidoctor when published via git-scm.com)
Enterprise Web Development: From Desktop to Mobile
Bintray REST API (https://bintray.com/docs/api.html) and User Guide (https://bintray.com/docs/bintrayuserguide.html)
Griffon Guide (http://new.griffon-framework.org/guide/latest/)
Spring Framework (Core, Data, Security, XD and more) (converted to DocBook using Asciidoctor)
Spring's Getting Started Guides http://spring.io/blog/2013/12/13/spring-s-getting-started-guides-migrated-to-asciidoctor
OpenShift Docs (https://github.com/openshift/openshift-docs)

Also Include Issue #236

recena commented 10 years ago

Thanks in advance.

We are writing the documentation now, totally in process. But we have a custom template, custom look&feel and all together working in Continuous Integration.

Regards,

mojavelinux commented 10 years ago

Excellent! Then it will be a great example for the extent to which the output can be customized. I love it!

recena commented 10 years ago

Absolutely!

mojavelinux commented 10 years ago

Granite DS - http://www.granitedataservices.com/public/docs/latest/docs/reference/flex/graniteds-refguide-flex.html Spring Data JPA - https://dl.dropboxusercontent.com/u/25310722/sdjpa-doc-preview.html

mojavelinux commented 10 years ago

Infinispan - http://infinispan.org/docs/7.0.x/user_guide/user_guide.html

mojavelinux commented 10 years ago

Groovy - http://docs.groovy-lang.org/latest/html/documentation/

mojavelinux commented 10 years ago

TomEE refcard: http://tomee.apache.org/refcard/refcard.html

dobermai commented 10 years ago

HiveMQ User Guide: hivemq.com/docs/hivemq/latest HiveMQ Plugin Documentation: http://www.hivemq.com/docs/plugins/2.0.1/

emmanuelbernard commented 10 years ago

Hibernate website uses Asciidoctor for most pages http://hibernate.org.

Hibernate OGM, Hibernate Validator, Hibernate Search use Asciidoctor for their documentation. They use the Maven plugin and wire it to the docbook backend while keeping the documentation in Asciidoc for faster editing.

Hibernate ORM uses Asciidoc for its topical guides

mojavelinux commented 9 years ago

Stardog: http://docs.stardog.com/

mojavelinux commented 9 years ago

Activiti: http://www.activiti.org/userguide/

mojavelinux commented 9 years ago

Anki: http://ankisrs.net/docs/manual.html
AnkiDroid: https://ankidroid.org/docs/manual.html

mojavelinux commented 9 years ago

Reactor: http://projectreactor.io/docs/

mojavelinux commented 9 years ago

Under the books category:

Python for Java - http://antrix.net/pages/python-for-java/

mojavelinux commented 9 years ago

JavaMoney specification: https://github.com/JavaMoney/jsr354-api/blob/master/src/main/asciidoc/JavaMoneySpecification.adoc

cerker commented 9 years ago

Hibersap project: http://hibersap.org

mojavelinux commented 9 years ago

PsyToolkit - www.psytoolkit.org

mojavelinux commented 9 years ago

Taiga - http://taigaio.github.io/taiga-doc/dist/ (includes a custom HTML5 backend with an offcanvas navigation menu; source: https://github.com/taigaio/taiga-doc)

mojavelinux commented 9 years ago

AjaxAnywhere - http://ajaxanywhere.com/documentation.html

mojavelinux commented 9 years ago

opendaylight - https://github.com/opendaylight/docs

They are using AsciiDoc to DocBook to generate the web help format.

mojavelinux commented 9 years ago

We should organize this list into books, software projects and perhaps other categories.

mojavelinux commented 9 years ago

Eclipse Scout. For details, see https://www.bsi-software.com/scout/documentation-platform/

mojavelinux commented 9 years ago

Another list can be found here: https://github.com/bodiam/awesome-asciidoc

mojavelinux commented 9 years ago

Apache HBase Reference Guide: https://hbase.apache.org/book.html

mojavelinux commented 9 years ago

Java for Kids: http://yfain.github.io/Java4Kids/

mojavelinux commented 9 years ago

arc42, software architecture - http://arc42.github.io/

mojavelinux commented 9 years ago

Vert.x 3 - http://vert-x3.github.io/docs/vertx-core/java/

mojavelinux commented 9 years ago

GroovyFX - http://groovyfx.org/docs/index.html Weld - https://github.com/weld/core/tree/master/docs/reference/src/main/asciidoc (uses DocBook toolchain to build final output from Asciidoctror-generated DocBook)

graphitefriction commented 9 years ago

I've sorted them into the following groups.

@mojavelinux Should I sort out Docs into websites and specs? Or are there better groupings?

Authors and Publishers

Enterprise Web Development: From Desktop to Mobile
Clojure Cookbook
NFJS, the Magazine
Python for Java
O’Reilly
MakerPress

Services

Noteshare.io
Hubpress.io
GitHub
GitLab
Atom Editor
Brackets Editor

Websites

Context and Dependency Injection for the Java EE Platform (CDI)
Hibernate

Docs

Git user manual (Via git-scm.com)
Bintray REST API and User Guide
Griffon Guide
Spring Framework (Core, Data, Security, XD and more)
Spring's Getting Started Guides
OpenShift
Clinker
Granite DS
Mule ESB
Infinispan
Groovy
TomEE refcard
HiveMQ User Guide
HiveMQ Plugin Documentation
Hibernate OGM, Hibernate Validator, Hibernate Search
Hibernate ORM
Stardog
Activiti
Anki
AnkiDroid
Reactor
Hibersap
PsyToolkit
Taiga
AjaxAnywhere
opendaylight
Eclipse Scout
Apache HBase Reference Guide
Java for Kids
arc42
Vert.x 3
GroovyFX
Weld

Specifications

Context and Dependency Injection for the Java EE Platform (CDI)
JavaMoney

Also, I need a status update on the following two:

Golo Programming Language Guide (AsciiDoc Python, soon to be Asciidoctor!)
Phusion Passenger Users Guides (AsciiDoc Python)

graphitefriction commented 9 years ago

Wireframe 1

Note: This is a wireframe, that's why there are gray boxes around the components. It's not a hi-fi mockup.

Note: The highlighted service, docs project, book, etc would change with each visit (i.e. we'd rotate them through a script <- but I don't mean via carousels, carousels are dirty :hankey: )

mock_1

mojavelinux commented 9 years ago

Fantastic!!

mojavelinux commented 9 years ago

I think it's good to have the specs be a separate category because it sends a strong message. Though, this category may evolve overtime to be something more general (for instance, it could incorporate documents in other enterprises like legal).

We'll probably want to sort the Docs category by how well the entries serve as an example so people discover the ones first that show Asciidoctor in the best light. We'll also need to think about how best to handle the Spring entries since it encompasses many great examples of Asciidoctor in action.

graphitefriction commented 9 years ago

Alt form of Wireframe 1

Somethings a little "meh" about the spacing in this one, but it could work because the "mores" in each category (like books) would only be a few, but for docs, there'd be a lot listed....hmmmmm

mock_2

graphitefriction commented 9 years ago

Maybe what it is missing is big, centered section headings like THE DOCS! THE BOOKS! THE SERVICES! THE JAZZ HANDS!

mojavelinux commented 9 years ago

Keep in mind, we could use an accordion to reveal the “more” list. We could even use one of those partially shown accordions like you see on news site (we hate them there, but here it would actually make sense).