www.ReactiveX.io Website #1
Comments
/cc @mattpodwysocki @headinthebox @GeorgiKhomeriki @DavidMGross @kirkshoop @jhusain @LeeCampbell |
Projects I expect in the near future evolving out of the RxJava side of things are:
|
Other projects (sitting with @headinthebox) would be:
|
For the docs to be written and maintained in GitHub, we could use a framework like Jekyll. It can generate static front-end pages from markdown templates. I've created a simple prototype using this in the jekyll branch. If Jekyll meets the requirements, we could use the prototype as a starting point. |
/cc'ing ReactiveCocoa and ReactiveUI owners, who might be interested: @jspahrsummers @joshaber @alanjrogers @dannygreg @jlaanstra @onovotny @tberman @haacked @niik We'd love to get in on this effort, having a shared website for a lot of related Reactive projects would be great for everyone involved, especially being able to contrast how the same "Rx Zen" applies across many different UI frameworks / languages.
I'm not sure that this part is as valuable as having the top-level ReactiveX website. If the top-level website is what everyone references, we can definitely direct people appropriately without trying to consolidate in the same org. Org pages aren't particularly great for discovering projects, we can do better via reactivex.io |
@GeorgiKhomeriki I have heard good things about Jekyll but have never tried using it. I'll play with your branch. The key is to make it easy for those who will be doing the most documentation writing, and that it easily supports integration with the code samples. @paulcbetts Great to have you involved on the site. I agree the site is more important than the colocation of code. There are many reasons why this repo makes good sense for several of the languages that @headinthebox and I are involved in, but by no means do all Rx implementations need to live here to achieve the desired Rx unification, and I'm sure there will be reasons for some not to be here. For the website, what would you change on the outline I posted above? How would you like to be involved or get started? We are just kicking this off. My goal right now is to get the bones of the site in place on github so we can all start contributing the documentation and code examples, as those are the two most important things in my opinion and the ones that will distribute to a team of contributors the best. |
@GeorgiKhomeriki I just played around with your branch and Jekyll looks like it will work well, and I like how the Markdown files living in Github get rendered there as well, so that seems like it will work well. We will not want to have each language with a different mini-site though, that defeats the purpose. Each language should have its own page, but the primary site and documentation needs to be unified. How do you want to establish the basic site map so we can get started? What about site design, styling and branding? |
I would like to volunteer for creating better documentation for the basic usage and gotchas of RxJava on Android. The rxjava-android module docs are painfully outdated anyway. I think there's also more interesting things we could do with the rxjava-android-samples. What's there right now really only shows some fundamental integration with the library, but is not really much inspiring about how to solve more difficult problems in an elegant way. |
@benjchristensen Good to hear that Jekyll meets the markdown requirements. |
I like the idea of the jekyll system. I had thoughts about making the code
|
It's my first pass at a site map and that in turn suggests the content I think we want included.
I don't think so.
I think these can just be source folders within the folder structure of the reactivex.github.io project. Each language should have a root folder and then if we all conform to the right paths and naming conventions, I'm hoping Jekyll or the Javascript can then just load the example code. For example:
|
@GeorgiKhomeriki Ignore my ignorance, and I am sure I already asked this several times before :-). If we are just doing a static site, can't we just do a GitHub wiki or regular HTML + boostrap? Jekyll seems a blog engine (https://help.github.com/articles/using-jekyll-with-pages), and I am not sure if we can leverage the templating much (I like less moving parts) |
If we use the wiki we can't control the UI, styling, branding etc, nor can we embed Javascript logic, such as needed for code examples that allow switching between languages. |
@benjchristensen That's what I thought wrt to wiki, not sure however what Jekyll code generation over standard HTML + http://getbootstrap.com/. Just want to make sure we pick the simplest technology that works. I am not a big fan of using models to generate code. Rather write things by hand. But then maybe I am traumatized by the previous job. |
@headinthebox That is indeed an option, however in that case all the documentation and content would need to be written in HTML instead of markdown. |
:-) |
Sorry for the delay, I've started a new branch in which I've set up Jekyll combined with Bootstrap. I think this combination is nice, especially since bootstrap adds "responsiveness", so mobile devices are also supported. It's just that the site currently looks a bit "standard" (since a lot of other websites also use bootstrap); we need a solid CSS design to customise the look-and-feel. We also need contents for the pages, for now I've copied a page from the RxJava wiki for testing purposes. It's really basic for now, but I just wanted to see if you think that this is going in the right direction? If not, I'll backtrack and try something else. |
@staltz is working on interactive marble diagrams: http://staltz.github.io/rxmarbles/ If possible we should work together to make this usable across all Rx documentation intended on reactivex.io |
@GeorgiKhomeriki what needs to happen to get the foundation of the site functional so we can starts migrating RxJava docs to reactivex.io? We are getting close to splitting RxJava into several projects and I'd like the new home for docs to be available. |
Another effort to create interactive marble diagrams: |
@benjchristensen I think currently the most pressing issue is to make the website work across different browsers. Then we simply need to populate the website with content and perhaps change the (css) style. I'm working on the dynamic code examples (loaded from github repos). |
Closing this one out; if there are unfinished subtasks, please file new issues specific to them. |
This issue is intended to kickoff the discussion of what the www.reactivex.io website should include and get the work started on it.
Here are example sites:
http://vertx.io (particular see how code examples are done for each language)
http://netty.io
http://www.ratpack.io
http://akka.io
http://emberjs.com
http://angularjs.org
http://spark.apache.org
The text was updated successfully, but these errors were encountered: