-
Notifications
You must be signed in to change notification settings - Fork 0
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
ALAN Manual 1st Release ETA #74
Comments
Well, I'm not a great fan of deadlines, especially in my hobby projects ;-) In the state we are now I think we could merge to master at any time after the Urgent Tasks are done. That would be the new version. It wouldn't be the 1st release, since https://alanif.se is already pointing to the PDF here, but it would be a better and updated version ;-) Then we could do other improvement work on master, continously providing better and better versions. Beta 8 feature descriptions should be introduced only on dev-man branch which then needs to be continuously rebased. (Or is this contradicting something we have already agreed upon when it comes to where we want to do what type of work?) |
I was just hoping to match the "new" Manual release with the StdLib update (which introduces significant improvements, and many bug fixes, beside the revamped and corrected StdLib Manual), I just though it would be a strong incentive for old (and new) ALAN users to dive again into ALAN during the season holidays.
Well, then let's focus on making it ready on
Most of all, I'd emphasize the collaborative aspect of this new version, thanks to AsciiDoc being a text source that can be easily edited collaboratively on GitHub (something that wasn't easy to do with docx/Word like documents).
No, this is correct, and it matches the updated |
On the other hand, if the new version of the ALAN manual is ready to be published long before the StdLib updated manual, wouldn't it be fine to just go ahead and release the ALAN manual before it? Then, when the StdLib manual also gets ready, there could be a reminder that the new version of the ALAN manual is (and has been, for some time) available as well. And/or, when publishing the new version of the ALAN manual, there could be a "pre-mention" of the StdLib + manual also being updated soon, and people could then start looking forward to that, as well? But, this is just my opinion :-). My point being, I don't wish that the StdLib updating work in any way interferes with/ jars what happens in the ALAN system otherwise, and with how Thomas wishes to bring things forward. I get your idea about the "marketing gimmick" of simultaneous publishing, Tristano, but the marketing can be still carried out even if the ALAN manual is published first... |
Yes, exactly what I was thinking. We should not let one delay the other. And we can make the "simultaneous" release of the two can be made into more of a publicity stunt ;-) And it might even happen that there's a beta8 at that time! That leaves us with only one essential task, the naming question in #76 and if it's associated discussion if it's possible to do some kind of CI build of the document (but that could also wait actually). (On CI-build: Travis, CircleCI and friends all allows you to use a docker image of your choosing. So it would be completely feasible to build one with the alan-doc required tooling and then use that in the associated CI job to generate a smoking fresh PDF/HTML version of both the master and the dev-man branches. Realised I haven't looked into what the current Travis jobs do...) |
OK then, I'll try to fix all the remaining details today so we'll be ready to merge into Yesterday I had a chance to look at the ALAN website, and how it links to the documents, and I've realized that it links directly to the docs on The reason I mentioned using CI to deploy the docs directly on ALAN website was mainly due to some limitations on the Live HTML Preview service — i.e. it requires all image assets to be hard-coded inside the document via Data-URI, and it doesn't work properly with highlight.js (in fact, I see that ALAN code is not being syntax highlighted on the Live Preview, whereas syntax highlighting works fine if you open the HTML doc locally). Hopefully, we'll be soon enabling the GitHub Pages website for this repository, so we'll be able to also serve the HTML documents online without needing the Live HTML service. The main obstacle to achieving that is the need to tweak the Asciidoctor templates in order to provide a navigation bar to allow end users to return to the main menu from the various documents, and then to provide an index page presenting the project. It's doable, but it requires some preparatory work and some dedicated scripts to update the GHPage website (I'd set it to serve from the |
You shouldn't be "working" if you are ill! (Yeah, I know...)
Cool, right! Bringing value without any work!
That's too bad on the pretty styling you created. But as long as we work towards providing a "perfect" HTML rendering I think we can live with that for now. I'll think how I could enable uploading an HTML-version to the Alan site from the Alan CI on https://ci.alanif.se. I almost nailed building the documentation on Cygwin, which is what ci.alanif.se is running primarily, but |
OK, released!
Hate staying in bed, but trying to rest too when I need (hence the long pauses).
I was thinking that you could include the build Manual (at lest the HTML version, which is lighter) with the ALAN package — although I'm not sure how this could be done without redundancy, since some packages are split into components. Well, the Manual is for authors, not players, so it could ship with the compiler SDK. |
Nice! Hurray! Time to celebrate! |
@thoni56, do we have an ETA for the first public release of the new ALAN Manual?
I realize that many Issues for pending tasks were originally added to the
New Alan Manual Release
Project just because we though we had so much time ahead of us, whereas now suddenly the Beta7 is already out, and we could probably move many non-essential Issues to theAlan Manual (dev)
Project instead (which is for long-terms updates of the Manual).New Alan Manual Release
— upcoming 1st release, for Beta7.Alan Manual (dev)
— long terms updates.I've already started to sift through the various pending Issues associated with the
New Alan Manual Release
Project and other Manual-related labels, moving to the long term that which is not strictly necessary.Still, there are some Issues which might be important for a first release, although not essentials (e.g. designing a proper cover for the PDF edition, and other aesthetic matters).
Maybe we could use this Issue thread to plan the ETA date and discuss what to resolve before the release and what to postpone to future updates.
Mid-November: StdLib v2.2.0 ETA
As mentioned elsewhere, @AnssiR66 and I were planning to release the new StdLib v2.2.0 somewhere around mid-November (a tight deadline, but we should meet it with some sacrifice), so we might consider releasing the new ALAN Manual together with the StdLib update — we could then announce them together, offering a big incentive for authors to give them a go during the Christmas holidays, when they'll have some free time to dedicate to writing a new IF work. We could also announce the new reprint of the ALAN Beginner's Guide, with the full examples sources; although it was already available here, some might have missed it.
Personally, I think this is going to be great news in the IF community, especially since the last year has been quite stale in terms of IF Systems updates (especially with Inform7 having missed it's v1.0 deadline altogether, and no further news updates were released).
ALAN Manual Live Preview links
These links point to the
dev-man
branch, and will work even after force-pushing to the PR:The text was updated successfully, but these errors were encountered: