Skip to content

Conversation

@dantleech
Copy link
Member

@wouterj
Copy link

wouterj commented May 11, 2014

I would prefer to change the blue in the menu to the same red as the logo. Apart from that, the design looks nice imo :)

index.html Outdated
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

this should get an indent :)

@dbu
Copy link
Member

dbu commented May 12, 2014

great, thanks!

i only have a few questions for the header:

  • make header more compact? there is a lot of space above PHPCR. (does the header scroll away or stay on top?)
  • make the PHPCR use a bold font? currently looks to light for me, and too standard purecss :-)

@dantleech
Copy link
Member Author

Started to refactor for Jeckyll - I was playing with the idea of using my PHPCR web framework, Slinp (https://github.com/dantleech/slinp), for the website, but finally decided against it. It is better to use a static site in this case.

One thing that might have been possible with a scripted page would have been a page which allowed users to see the features supported by each implementation (by reading the repositories descriptors) - but I guess we could generate this, or just maintain the tables manually.

@dbu
Copy link
Member

dbu commented May 25, 2014

jekyll can be somewhat limited, but will be simple to maintain on this infrastructure, so +1 for sticking with that. thanks dan, looking forward to the new site.

@dantleech
Copy link
Member Author

Updated again, the outline of the whole website as I see it is there now. Need to transplant some tutorials into it and add some more content.

Will post a demo soon.

@dantleech
Copy link
Member Author

ok heres the current WIP: http://phpcrwebsite.dantleech.com

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

i think one title "Reference" would be enough, and then have first API Reference and then add the sql2 reference once we have it.

@dbu dbu changed the title [WIP] New Websitre [WIP] New Website May 27, 2014
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Tools? and list the marmelab browser as well? i know that you also have a tools page, but i think that is ok. or we could just link to the tools page from here to avoid reduncancy.

@dbu
Copy link
Member

dbu commented May 27, 2014

we might also move https://github.com/phpcr/phpcr#port-status somewhere into this page (with a different title like "JCR and PHPCR")

@dantleech
Copy link
Member Author

Updated again, removed the @todos and linked to slides and imported the "PHPCR Tutorial" from phpcr-docs (I guess that is now redundant?)

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Are there other slides (ither than those mentioned above)?

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

not that i know of. the credits for the intro slides should go to lukas as well, he did work on that too. and the filename should be intro.html or something.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't see any intro.html file ..

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I mean: we should rename the presentation filename from "slides" to "phpcr-intro".

----- Reply message -----
Von: "dantleech" notifications@github.com
An: "phpcr/phpcr.github.io" phpcr.github.io@noreply.github.com
Cc: "David Buchmann" david@liip.ch
Betreff: [phpcr.github.io] [WIP] New Website (#3)
Datum: Fr., Mai. 30, 2014 15:10
In documentation/index.md:

+layout: default
+title: Documentation
+---
+### Tutorials

+- General Tutorial
+- Integrating with Symfony

+### Reference

+- API Reference

+### Slides

+- PHPCR Introduction by David Buchmann
+- PHPCR, Une Introduction by Daniel Leech (in French)

I don't see any intro.html file ..


Reply to this email directly or view it on GitHub.

@dantleech
Copy link
Member Author

Added a "news" section

@lsmith77
Copy link
Member

imho once the site is decently useable on mobile devices we should merge. no need to try and cover everything in this PR

@dantleech
Copy link
Member Author

ok, it should be responsive now ... I have to go now so cannot verify, but have updated the site

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

can we depend on phpcr-docs and pull this file in in the Makefile? having a copy of the tutorial is going to make them diverge fast.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ah, or in the jekyll build instructions, if we can control that at all...

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

i was thinking more of deprecating the phpcr-docs and having all the docs on the website, its easier to manage I think (and we can take advantage of jekyll features like syntax highlighting). Otherwise we would have to find a way serve the phpcr-docs independently and integrate them into this site.

@dbu
Copy link
Member

dbu commented May 30, 2014

I would vote against making the "news" section the home page. we won't have many news and then it will look weird. the main reason for this site imho is to point people not knowing about phpcr there so they can find out about it.

@dantleech
Copy link
Member Author

I think the news should be on the front page -- its a way of informing visitors about PHPCR news who are there for other reasons (e.g. looking at documentation).

I think there could be regularish news, e.g. when PHPCR is talked about at conferences, new tools (phpcr-shell, phpcr browser) and updates for those tools, user stories, new implementations (e.g. OAK) etc.

There is a risk it could make the project look dead if it is not maintained, but if it is maintained it makes the project look alive, which encourages people :)

@dantleech
Copy link
Member Author

Renamed the PHPCR-tutorial to "PHPCR Guide" and added syntax highlighting.

@dbu
Copy link
Member

dbu commented May 30, 2014

Cool. Can you please do a Pr on phpcr-docs to replace the tutorial contnet with a link to where the guide will be online?

----- Reply message -----
Von: "dantleech" notifications@github.com
An: "phpcr/phpcr.github.io" phpcr.github.io@noreply.github.com
Cc: "David Buchmann" david@liip.ch
Betreff: [phpcr.github.io] [WIP] New Website (#3)
Datum: Fr., Mai. 30, 2014 15:23
Renamed the PHPCR-tutorial to "PHPCR Guide" and added syntax highlighting.


Reply to this email directly or view it on GitHub.

@dbu
Copy link
Member

dbu commented May 30, 2014

Okay, lets go with news for front and we each schedule us a monthly reminder to check if there is news. If we have no news for 2 months we switch to about (and back to news when we have new news). Deal?

Do you squash and merge?

- New website using Jekyll
- New logo (or rather, we have a logo!)
- Imported PHPCR tutorial from phpcr-docs
@dantleech
Copy link
Member Author

Sounds good, I have squashed ..

dantleech added a commit that referenced this pull request May 31, 2014
@dantleech dantleech merged commit a8e31ae into master May 31, 2014
@dantleech
Copy link
Member Author

I have merged...

@dantleech dantleech deleted the new-website branch May 31, 2014 06:40
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants