Asciidoctor :: Discussion

Create an Asciidoctor DZone refcardz

_‹ Previous Topic Next Topic _›

Classic

List

Threaded

5 messages Options

ggrossetie

Create an Asciidoctor DZone refcardz

Hello,

I think it could be great to create a DZone refcardz for AsciiDoc/Asciidoctor, what do you think ?
I don't really know the process for making this happen but if the community think this is a good idea I could ask @mrhaki (Hubert Klein Ikkink) as he already published blog posts on DZone.

https://dzone.com/refcardz

taxi

Re: Create an Asciidoctor DZone refcardz

yes, definitely its a good idea

mojavelinux

Re: Create an Asciidoctor DZone refcardz

Administrator

In reply to this post by ggrossetie

This idea came up a while ago and we reached out to DZone. Unfortunately, they weren't interested.

AsciiDoc sounds cool, but wouldn't make the hottest refcard topic right now -- basically because (a) this topic-space is relatively small, (c) developer excitement is relatively low (even if it *ought* to be higher), and (c) even within this space, Markdown is similar but (I think) more popular. (Let me know if you disagree on any of these points, though.)

The e-mail goes on to say that would be willing to do it, but they couldn't offer a stipend for it like they normally do.

Frankly, I don't think we need DZone. Forget them. They'll make us use Word anyway. I think we can do one ourselves.

Neo4j created a backend for AsciiDoc Python that generates output that looks similar to a refcard.

http://neo4j.com/docs/stable/cypher-refcard/

Source: https://github.com/neo4j/cypher-refcard

We could do the same for Asciidoctor.

This would be a great project for our emerging documentation group. Perhaps we should start with an issue in the asciidoctor.org repository. wdyt?

Cheers,

-Dan

On Mon, Apr 18, 2016 at 6:46 AM, ggrossetie [via Asciidoctor :: Discussion] <[hidden email]> wrote:

Hello,

I think it could be great to create a DZone refcardz for AsciiDoc/Asciidoctor, what do you think ?
I don't really know the process for making this happen but if the community think this is a good idea I could ask @mrhaki (Hubert Klein Ikkink) as he already published blog posts on DZone.

https://dzone.com/refcardz

If you reply to this email, your message will be added to the discussion below:
http://discuss.asciidoctor.org/Create-an-Asciidoctor-DZone-refcardz-tp4619.html

To start a new topic under Asciidoctor :: Discussion, email [hidden email]
To unsubscribe from Asciidoctor :: Discussion, click here.
NAML

Dan Allen | @mojavelinux | http://google.com/profiles/dan.j.allen

ggrossetie

Re: Create an Asciidoctor DZone refcardz

The Neo4j's refcard backend is looking great!
I first mention DZone because we could benefit from their "large" audience but let's forget them.

I will create an issue in the asciidoctor.org repository or in the asciidoctor backend repository ?

Cheers.
Guillaume

mojavelinux

Re: Create an Asciidoctor DZone refcardz

Administrator

Let's track it from the asciidoctor.org repo.

I'd say we have our own large audience who will greatly appreciate this reference. Let's do it.

-Dan