Comments (7)
@jaredmorgs This relates to the problem I mentioned in your last pull request to asciidoctor.org. The plan was to have these pages synced automatically (the website sourcing from the README in the repository). However, we didn't get around to it and now the files have diverged. This issue is covered in part by asciidoctor/asciidoctor.org#366.
Of course, we could do a manual sync in the meantime just so that the information is more updated...but that doesn't solve the problem long term.
from asciidoctor-reveal.js.
I would recommend rebuilding all Asciidoctor pages to ensure the latest data is live.
Since several of the files have diverged, we have to handle this very carefully. We are learning our lesson the hard way, unfortunately. Automation is not to be put off.
from asciidoctor-reveal.js.
To fix the issue, would we need to do a diff on each readme vs live page and take the README as canonical?
Then see if @johncarl81 could suggest some ways of using JAQ to automate builds. I'm not sure if that rake task currently implemented in the JAQ is compatible with Awestruct.
Out of scope for this bug, but I'd love to work out how to use JAQ to automate other things as well. I'd need to read up more about how @jirutka made the rake task, and how it could be customized (if it even needs to be customized).
from asciidoctor-reveal.js.
@mojavelinux So how would we handle the re-merge?
I think that while having a strategy for better synchronized documentation in the short to medium term is important, what's even more important is to sync the public-facing docs with reality (that is, what is in the READMEs)
I think another thing to do is to code the EDIT
button to redirect back to the README. I think if it did that, much of the issue with file synchronization would be alleviated because the README PRs would be a reminder to rebuild, until we could implement a CI strategy.
from asciidoctor-reveal.js.
Just submitted this PR asciidoctor/asciidoctor.org#620 which is related to this issue.
from asciidoctor-reveal.js.
Because of the creation of http://asciidoctor.org/docs/asciidoctor-revealjs/ I think this has been resolved to anyone's satisfaction. If not please re-open.
As a side note, I just sent PR asciidoctor/asciidoctor.org#718 and I'll update my release notes not to forget in the future. So this stalled issue has been beneficial 😄
from asciidoctor-reveal.js.
Updated!
http://asciidoctor.org/docs/asciidoctor-revealjs/
from asciidoctor-reveal.js.
Related Issues (20)
- Activating Reveal.js Extensions only for Reveal.js backend HOT 1
- Remote presentation shows only source code of presentation notes HOT 3
- Custom highlight.js display errors HOT 3
- Support for table row fragments HOT 2
- 2-column for _part_ of a slide HOT 1
- Multiple authors not taken into consideration in revealjs output. HOT 2
- SECURITY - Update `Reveal.js` version dependency to latest to resolve CVE-2022-0776 HOT 1
- Document that speaker notes will be displayed as plain-text when using a CDN (jsDeliver in particular) HOT 5
- video not displayed HOT 1
- Source code block highlighting for Haskell HOT 2
- The :email: thingy is disregarded in the title slide HOT 2
- Block quote attribution looks misaligned
- Source code block is cut HOT 14
- Use GitHub CLI to create a release and upload the dist
- Compatibility Matrix is out of date HOT 2
- Create a "what's new" presentation for 5.0
- Clarify the Custom Styles documentation page HOT 1
- title-slide-background-gradient missing HOT 2
- Support STEM/Math feature using reveal.js built-in feature
- Background bug in reveal.js 4.1 HOT 1
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from asciidoctor-reveal.js.