Moya website.

[sunshinejr]

Hey guys! In #1078, @orta made a good point that maybe we should think about a website for Moya. What do you think about it, @Moya/contributors? 🤔

Personally, I don't have much experience with that, so we would need to have someone taking care of that project.

[juliengdt]

Using github.io website generator, or even jekyll can be a good solution for a brief and good website !

EDIT: Jekyll with Github

[BasThomas]

What would be the advantage compared to a list in the repo? Or maybe: what would we want to get out of a website apart from just a list of project built with / on top of / extending Moya?

[BasThomas]

Also, as @juliengdt mentioned, I think doing so with Jekyll would be pretty nice, as I think most of us (?) already have some experience with it.

[sunshinejr]

I think we don't have to constraint it only to the community around Moya (projects/extensions/etc), but we can also show examples/tutorials/documentation there as well. We could also show how we do open source or how to start contributing. We'd have everything in docs, but website may be an alternative way of presenting the important stuff. But that makes me wonder, can we connect the website with our markdown docs fairly easy? Would it be time-consuming to maintain it?

[juliengdt]

Even without Jekyll. A good start could be to check the Github Pages, which can use easily the markdown doc in the repo.

Source: Github Pages

[ashfurrow]

I've helped out with similar sites like this one: https://github.com/RxSwiftCommunity/rxswiftcommunity.github.io Jekyll is great, Middleman is also great. Whatever people are familiar with sounds good to me.

[sunshinejr]

Great! I think we can start with a skeleton in Jekyll as a first step. Does anyone here want to take a stab at it?

[BasThomas]

If we get around to doing this, it would be fantastic if we could allow contributors to add blog posts on Moya there, too.

[SD10]

I was thinking of cleaning up Moya's in source documentation and generating documentation using jazzy. We would need to create a moya.github.io repo to host the page. Is anyone opposed to this? @Moya/contributors

I have no web development skills so it would only be jazzy for now, but this gets the ball rolling.

[ashfurrow]

I have no objections – starting with Jazzy makes sense. As I mentioned above, Middleman is also nice, but the cool thing the hip kids are using these days is Gatsby. I've not used it yet but am planning on looking over the free Eggheads course tonight.

[SD10]

Awesome, I started here: https://moya.github.io. Checking out what the current status of the docs look like.

That Eggheads link is awesome btw, I may try to learn a little web development. I feel limited because I don't know Javascript (would prefer learning Typescript first if possible TBH). I doubt anyone wants me to work on the Moya website in Elixir or Go 😂

[SD10]

I'm starting to learn React this morning so I will probably move forward with making Moya a website. Likely using Gatsby. Hope everyone is ok with that setup

[BasThomas]

Go for it!