Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Already on GitHub? Sign in to your account

Prepare (aka update) the site content for Heist 0.10 #23

Open
adinapoli opened this Issue Sep 26, 2012 · 10 comments

Comments

Projects
None yet
3 participants
Member

adinapoli commented Sep 26, 2012

Hi guys,

maybe I'm not getting something crucial but as far as I can see, the Heist APIs changed a lot from 0.8 to 0.10. The most relevant example is that:

Text.Templating.Heist

Does not exists anymore. So far so good, being 0.8 the last stable release, but with the 0.10 release a lot of website documentation will become stale.
Take a look here:

http://snapframework.com/docs/tutorials/heist

At the bottom of the site you'll see the old API gets called.

I suggest we create another branch for this temporary transition, so we can update all the due documentation, preserving the stable one until 0.10 is released. Once 0.10 is out, simply merging from 0.10 to master will update the site with the correct APIs and infos. This applies also for snap,
because now wrapHandlers is gone. When snap 0.10 will be out, we need also to change every occurrence of wrapHandlers to wrapSite.

Obviously I can create this branch locally and then pull req everything when the time will come.

What do you reckon?

Owner

mightybyte commented Sep 26, 2012

A new branch is perfect. Thanks for working on this.

Member

adinapoli commented Sep 26, 2012

It's a pleasure :)

Member

adinapoli commented Sep 27, 2012

Just to keep everyone posted, I've complete the migration toward heist 0.10, snap 0.10 and snap-core 0.9.2.1, including the addTemplatesAt we talked about. The site seems fully functional, including the blog. Now I'm switching my focus on update stable content (e.g. wrapHandlers must be gone, same applies for Text.Templating.Heist). I'll also write the migration rule to 0.10, so if you have any observation please let me know.

ps. It would be beneficial for me to post here mismatches I encounter updating the tutorial material. If you think is an appropriate place, please let me know.

Member

adinapoli commented Oct 15, 2012

A bump just to remember you that, although not explicitly pull-requested, I have the updated website in my repos, ready to be integrated/revised :)

Owner

mightybyte commented Oct 15, 2012

Thanks. I'm not going to pull this until 0.10 is released to hackage.

Owner

gregorycollins commented Oct 16, 2012

Pull it into a branch maybe?

Member

adinapoli commented Oct 16, 2012

Hi Greg,
I've pulled it inside my local branch, obviously, but I don't have the
permission to create branches of the snapframework/snap-website.
If you or Doug create a new branch, I can pull-req there.

Bear in mind that my changes affects snap-static also (and maybe another
package I can't remember now) so we have to create appropriate branches
accordingly.

Bye,
A.

On 16 October 2012 11:03, Gregory Collins notifications@github.com wrote:

Pull it into a branch maybe?


Reply to this email directly or view it on GitHubhttps://github.com/snapframework/snap-website/issues/23#issuecomment-9477624.

Owner

gregorycollins commented Oct 16, 2012

That's what I meant, we should pull it into a branch on the main snap-website repo.

Owner

mightybyte commented Oct 16, 2012

Ok, I pulled it in. I'll leave this issue open until we make the final switch.

Member

adinapoli commented Oct 16, 2012

Perfect, thanks guys :) 👍

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment