Add ability to comment and ask questions on published Ceylondoc

[CeylonMigrationBot]

[@emmanuelbernard] I have seen that on a language somewhere. I found the idea interesting and community friendly. Snce we want to be social and since we are building the APIs of the future, such way to provide feedback would be quite interesting.

Should it be on all Ceylondoc or only on Ceylondoc published in modules.ceylon-Lang.org, I would say, initially only on modules. We could either use disqus or create a comment system off herd.

[Migrated from ceylon/ceylon-compiler#685]

[CeylonMigrationBot]

[@FroMage] I already had similar issues open for Herd

Sent from my phone

----- Reply message ----- From: "Emmanuel Bernard" reply@reply.github.com To: "Stéphane Épardaud" stef@inforealm.org Subject: [ceylon-compiler] Add capacity to comment and ask questions on published Ceylondoc (#685) Date: Tue, Jul 10, 2012 09:44

I have seen that on a language somewhere. I found the idea interesting and community friendly. Snce we want to be social and since we are building the APIs of the future, such way to provide feedback would be quite interesting.

Should it be on all Ceylondoc or only on Ceylondoc published in modules.ceylon-Lang.org, I would say, initially only on modules. We could either use disqus or create a comment system off herd.

---

Reply to this email directly or view it on GitHub:

685

[CeylonMigrationBot]

[@tombentley] We could add command line options for including custom CSS and Javascript files into the module doc, which would allow users (including us, in ceylon-sdk) the ability to hook their own scripts into the generated doc. Comments are one way this could be used, but I'm sure users could think of others. Just a thought.

(I'd love a HTML5 app which allowed you to drop types onto a canvas and see their relationships, but that would require something like a JSON representation of the model in order to know what those relationships are.)

[CeylonMigrationBot]

[@FroMage] Moving to M5.

[CeylonMigrationBot]

[@FroMage] Moving to M6

[CeylonMigrationBot]

[@thradec] This functionality is already implemented in Herd on the level of modules. I would say it is enough for 1.0. Can I close it?

[CeylonMigrationBot]

[@FroMage] Well, Herd has comments but on modules, not on ceylondoc. There's no way to ask questions on the API ATM. This issue would allow us to add a question on a class/method/attribute for example. But honestly it can wait for after 1.0 this is ultra-low priority.

[CeylonMigrationBot]

[@FroMage] Moving to 1.2