Re: Syngrafias - AsciiDocs Collaboration Tool for Fedora Documentation Maintainers, Available for testing

[Benson Muite]

On 1/4/21 9:28 AM, Akashdeep Dhar wrote:

Hello,

The suggestions made here 
https://lists.fedorahosted.org/archives/list/devel@lists.fedoraproject.org/message/CXXZ6YIL22Y34SIFT6XWK3DL3FD5VCLF/
 and 
https://lists.fedorahosted.org/archives/list/devel@lists.fedoraproject.org/message/ZWSKCQ2BQD4UZJAKEDNREF3FX6RVCDAR/
 are taken into account in the most recently made PR 
https://github.com/t0xic0der/syngrafias/pull/94. Feel free to take a look at it.

Thanks for implementing the suggestion.
___
devel mailing list -- devel@lists.fedoraproject.org
To unsubscribe send an email to devel-le...@lists.fedoraproject.org
Fedora Code of Conduct: 
https://docs.fedoraproject.org/en-US/project/code-of-conduct/
List Guidelines: https://fedoraproject.org/wiki/Mailing_list_guidelines
List Archives: 
https://lists.fedoraproject.org/archives/list/devel@lists.fedoraproject.org

Re: Syngrafias - AsciiDocs Collaboration Tool for Fedora Documentation Maintainers, Available for testing

[Akashdeep Dhar]

Hello,

The suggestions made here 
https://lists.fedorahosted.org/archives/list/devel@lists.fedoraproject.org/message/CXXZ6YIL22Y34SIFT6XWK3DL3FD5VCLF/
 and 
https://lists.fedorahosted.org/archives/list/devel@lists.fedoraproject.org/message/ZWSKCQ2BQD4UZJAKEDNREF3FX6RVCDAR/
 are taken into account in the most recently made PR 
https://github.com/t0xic0der/syngrafias/pull/94. Feel free to take a look at it.

Regards,
Akashdeep Dhar
t0xic0der
___
devel mailing list -- devel@lists.fedoraproject.org
To unsubscribe send an email to devel-le...@lists.fedoraproject.org
Fedora Code of Conduct: 
https://docs.fedoraproject.org/en-US/project/code-of-conduct/
List Guidelines: https://fedoraproject.org/wiki/Mailing_list_guidelines
List Archives: 
https://lists.fedoraproject.org/archives/list/devel@lists.fedoraproject.org

Re: Syngrafias - AsciiDocs Collaboration Tool for Fedora Documentation Maintainers, Available for testing

[Akashdeep Dhar]

Hey Matthew!

> This is super, super cool!

We are so glad to know that you liked the idea. :)

> One suggestion I have is to start in the simpler "Unity" mode rather than
> the "Cellular" one by default. Also, in the Cellular one, provide a button
> or something to add a new cell rather than requiring the menu item -- it
> took me an embarrassingly long time to figure out how to start typing.

Noted. We would make the "Unity Mode (ADOC)" as the default and give users the 
choice to move on to a much more sophisticated "Cellular Mode". Also, in order 
to add cells we are working on "Tabs UI" that we would love for you to take a 
look. You can find the preview of it here at 
https://github.com/t0xic0der/syngrafias/pull/87#issuecomment-752829071 and this 
makes adding cells and working on them a breeze.

> As an end-state goal, I'd love to so anyone clicking "edit" on a page on
> the
> docs site got this editor!

Sounds like an awesome plan to me. What do you say @nasirhm?

Thank you for taking the time out to review the public preview and suggesting 
the
changes. Wish you a very happy 2021! :D

Regards,
Akashdeep Dhar
t0xic0der
___
devel mailing list -- devel@lists.fedoraproject.org
To unsubscribe send an email to devel-le...@lists.fedoraproject.org
Fedora Code of Conduct: 
https://docs.fedoraproject.org/en-US/project/code-of-conduct/
List Guidelines: https://fedoraproject.org/wiki/Mailing_list_guidelines
List Archives: 
https://lists.fedoraproject.org/archives/list/devel@lists.fedoraproject.org

Re: Syngrafias - AsciiDocs Collaboration Tool for Fedora Documentation Maintainers, Available for testing

[Matthew Miller]

On Tue, Dec 29, 2020 at 04:01:26PM +0500, Nasir Hussain wrote:
> We would love to hear your feedback. Please keep in mind that this is a
> testing deployment and is currently running on an underpowered cloud
> instance. We are proposing it as a candidate GSoC project for it to be
> deployed, maintained and integrated in the Fedora Infrastructure this
> summer. Also the deployment goes offline on 8th January so be sure to
> check it out soon.

This is super, super cool!

One suggestion I have is to start in the simpler "Unity" mode rather than
the "Cellular" one by default. Also, in the Cellular one, provide a button
or something to add a new cell rather than requiring the menu item -- it
took me an embarrassingly long time to figure out how to start typing.

As an end-state goal, I'd love to so anyone clicking "edit" on a page on the
docs site got this editor!

-- 
Matthew Miller

Fedora Project Leader
___
devel mailing list -- devel@lists.fedoraproject.org
To unsubscribe send an email to devel-le...@lists.fedoraproject.org
Fedora Code of Conduct: 
https://docs.fedoraproject.org/en-US/project/code-of-conduct/
List Guidelines: https://fedoraproject.org/wiki/Mailing_list_guidelines
List Archives: 
https://lists.fedoraproject.org/archives/list/devel@lists.fedoraproject.org

Re: Syngrafias - AsciiDocs Collaboration Tool for Fedora Documentation Maintainers, Available for testing

[Akashdeep Dhar]

Hey Benson,

Thank you so much for taking some time out to check the public preview.

> Nice. Consider using a
> temporary domain name for this. For example from 
> Freenom.

We are considering a domain name for it and would surely keep you posted, 
should we obtain one.

> Are there any similar tools in other languages (Go, Rust, Crystal)? 
> Python runtime includes heavy batteries, so not great for underpowered 
> instances, though useful for rapid development.

There are libraries for websockets in Go but with much divisive community 
support for each. When it comes to Python, we are using the excellent 
websockets library created by @aaugustin. (But yes, we are keeping our eyes on 
a Go rewrite down-the-line for speedup and efficiency should the Python 
implementation feel heavy)

> A link to an Asciidoc cheatsheet maybe a good
> tip to have. Examples include:
> https://powerman.name/doc/asciidoc
> https://www.writethedocs.org/guide/writing/asciidoc/
> One could also create one, but the tips and documentation section seems 
> not to be currently available at
> https://github.com/t0xic0der/syngrafias

We do have general usability documentation as a part of the help and support 
topics which was introduced as of 
https://github.com/t0xic0der/syngrafias/pull/88 but adding an Asciidoc 
cheatsheet sound like an awesome idea. I have filed a feature request ticket 
here at https://github.com/t0xic0der/syngrafias/issues/91 which you can track 
for your reference and this would be prioritized.

Thank you for taking your time out to review the public preview and suggesting 
the changes. Wish you a very happy 2021! :D

Regards,
Akashdeep Dhar
t0xic0der
___
devel mailing list -- devel@lists.fedoraproject.org
To unsubscribe send an email to devel-le...@lists.fedoraproject.org
Fedora Code of Conduct: 
https://docs.fedoraproject.org/en-US/project/code-of-conduct/
List Guidelines: https://fedoraproject.org/wiki/Mailing_list_guidelines
List Archives: 
https://lists.fedoraproject.org/archives/list/devel@lists.fedoraproject.org

Re: Syngrafias - AsciiDocs Collaboration Tool for Fedora Documentation Maintainers, Available for testing

[Benson Muite]

On 12/29/20 2:01 PM, Nasir Hussain wrote:

Hi,

We'd like to announce the public testing of Syngrafias, an Asciidoctor
collaboration tool - a service for Fedora documentation maintainers 
aiming to

provide an environment where they can collaborate by sharing their workspace
among multiple contributors with active synchronization of edits at 
every end

and live preview of the Asciidoctor files.

Good idea.


The preview version for public testing is now available here:
http://35.231.107.163/ 
Nice. Consider using a temporary domain name for this. For example from 
Freenom.


Please note that as it has been deployed on a low-tier Google Cloud 
instance,

the first load might take a while.

Syngrafias leverages WebSockets backend to significantly improve upon the
collaboration experience among multiple documentation writers and ensures an
ultralight implementation of the workspace server. (~2MB above Python 
runtime)
Are there any similar tools in other languages (Go, Rust, Crystal)? 
Python runtime includes heavy batteries, so not great for underpowered 
instances, though useful for rapid development.


It also includes the following features -

- Live Asciidoc editing and preview

A link to an Asciidoc cheatsheet maybe a good tip to have. Examples include:
https://powerman.name/doc/asciidoc
https://www.writethedocs.org/guide/writing/asciidoc/
One could also create one, but the tips and documentation section seems 
not to be currently available at

https://github.com/t0xic0der/syngrafias
___
devel mailing list -- devel@lists.fedoraproject.org
To unsubscribe send an email to devel-le...@lists.fedoraproject.org
Fedora Code of Conduct: 
https://docs.fedoraproject.org/en-US/project/code-of-conduct/
List Guidelines: https://fedoraproject.org/wiki/Mailing_list_guidelines
List Archives: 
https://lists.fedoraproject.org/archives/list/devel@lists.fedoraproject.org

Syngrafias - AsciiDocs Collaboration Tool for Fedora Documentation Maintainers, Available for testing

[Nasir Hussain]

Hi,

We'd like to announce the public testing of Syngrafias, an Asciidoctor
collaboration tool - a service for Fedora documentation maintainers aiming
to
provide an environment where they can collaborate by sharing their workspace
among multiple contributors with active synchronization of edits at every
end
and live preview of the Asciidoctor files.

The preview version for public testing is now available here:
http://35.231.107.163/

Please note that as it has been deployed on a low-tier Google Cloud
instance,
the first load might take a while.

Syngrafias leverages WebSockets backend to significantly improve upon the
collaboration experience among multiple documentation writers and ensures an
ultralight implementation of the workspace server. (~2MB above Python
runtime)

It also includes the following features -

- Live Asciidoc editing and preview
- Workspace identity can be shared among multiple people to collaborate in
real time
- Documents can be exported locally and imported in different workspaces
- Unintrusive and focussed editing with cells inside a document

We would love to hear your feedback. Please keep in mind that this is a
testing
deployment and is currently running on an underpowered cloud instance. We
are
proposing it as a candidate GSoC project for it to be deployed, maintained
and
integrated in the Fedora Infrastructure this summer. Also the deployment
goes
offline on 8th January so be sure to check it out soon.

Feel free to provide ideas or bug reports at
https://github.com/t0xic0der/syngrafias or simply send an email reply to
this
thread with all kinds of feedback and suggestions.

---
Nasir Hussain
___
devel mailing list -- devel@lists.fedoraproject.org
To unsubscribe send an email to devel-le...@lists.fedoraproject.org
Fedora Code of Conduct: 
https://docs.fedoraproject.org/en-US/project/code-of-conduct/
List Guidelines: https://fedoraproject.org/wiki/Mailing_list_guidelines
List Archives: 
https://lists.fedoraproject.org/archives/list/devel@lists.fedoraproject.org