Design ideas for the website of the repo

[charlottebrf]

Hi all,

My next step for this repo is to create a static website that pulls data from these markdown files. I've had some help from a friend @felipesere to create some designs before I start building.

If you've got any feedback on the early designs that would be great! Thanks @mbaldwinsmith @serenahathi @alaskaa @ipapast @Whatapalaver @JennyBrennan @NathanGloyn @Sam-Rowe @jonathanfrancisco @katjad @jessicatee @empowerweb @federikovi @dmgarland @eddiejaoude @mormolis @jsjoeio @TheMicroGirl @mitchelldawkinsjr @MissDove @mickey167

[eddiejaoude]

Looks good. Might be easier to store the data in json or yml files instead of markdown?

[charlottebrf]

Thanks @eddiejaoude good point. However, I was thinking to use Gatsby which can pull in .md files. I wanted to keep .md files to make it as easy as possible for people to contribute. What do you think?

Also what do you think about an Open source projects section? For project based learning.

[Whatapalaver]

Gatsby sounds interesting, also I like the idea of the open source section.

Yesterday I came across something called Open NASA or perhaps Open Space which was a Hackathon I had just missed. Despite it being a lost opportunity the site was stacked with project ideas and resources (APIs) that you were free to run with at anytime. I thought a project ideas / resources section would work well with you newbies site.

Regards Angela

On Mon, 29 Oct 2018 at 07:01, Charlotte Fereday notifications@github.com wrote:

Thanks @eddiejaoude https://github.com/eddiejaoude good point. However, I was thinking to use Gatsby https://www.gatsbyjs.org which can pull in .md files. I wanted to keep .md files to make it as easy as possible for people to contribute. What do you think?

Also what do you think about an Open source projects section? For project based learning.

— You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub https://github.com/charlottebrf/coder-newbie-advice/issues/39#issuecomment-433806945, or mute the thread https://github.com/notifications/unsubscribe-auth/AGQeuatFCKbHyWyQ9_1nfR6GxF2fV65-ks5upqfagaJpZM4X-NVp .

[eddiejaoude]

I wanted to keep .md files to make it as easy as possible for people to contribute

Sure, I understand. This is a difficult one because you are right markdown does lower the barrier to entry, but is less flexible, in the future if you wanted to make changes to how the data is used 🤓

Also what do you think about an Open source projects section? For project based learning

Great idea 👍

[felipesere]

Well thought out yml files are really close to markdown, especially if you focus on lists of links etc. What we would loose is the Github preview. 🤔

[eddiejaoude]

Well thought out yml files are really close to markdown, especially if you focus on lists of links etc. What we would loose is the Github preview

Is the preview in GitHub still needed if a website is going to be generated from it?

[eddiejaoude]

I was thinking to use Gatsby

Does Gatsby support PWA? It would be great to have it available offline and as an app on the mobile device too 🤓

[NathanGloyn]

If Gatsby requires the minimum amount of work right now to work with the md files I'd suggest doing that.

I don't think it needs to be a PWA to begin with, to be honest would question if it even has to be mobile friendly.

Get it out there and get people using it before deciding where to go next with it

[jsjoeio]

If I could jump in and add my two cents, I +1 using Gatsby. It would definitely lower the barrier of entry if we're working with markdown files.

And yes, Gatsby sites are PWA out of the box 😄

Also Gatsby sites are super fast! And we can use host it with Netlify for free, which comes with previews and continuous deployment for free.

[charlottebrf]

Thanks for the interesting comments & input @jsjoeio @eddiejaoude @NathanGloyn @felipesere @Whatapalaver - really helpful! I will try it out with Gatsby first & can always change if it turns out to not be working. Thanks 👍

[charlottebrf]

Gatsby sounds interesting, also I like the idea of the open source section. Yesterday I came across something called Open NASA or perhaps Open Space which was a Hackathon I had just missed. Despite it being a lost opportunity the site was stacked with project ideas and resources (APIs) that you were free to run with at anytime. I thought a project ideas / resources section would work well with you newbies site. Regards Angela … On Mon, 29 Oct 2018 at 07:01, Charlotte Fereday @.***> wrote: Thanks @eddiejaoude https://github.com/eddiejaoude good point. However, I was thinking to use Gatsby https://www.gatsbyjs.org which can pull in .md files. I wanted to keep .md files to make it as easy as possible for people to contribute. What do you think? Also what do you think about an Open source projects section? For project based learning. — You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub <#39 (comment)>, or mute the thread https://github.com/notifications/unsubscribe-auth/AGQeuatFCKbHyWyQ9_1nfR6GxF2fV65-ks5upqfagaJpZM4X-NVp Interesting! Will have a google about thanks @Whatapalaver

[jessicatee]

I don’t have much input on anything spoken about so far, and I don’t know anything about gatsby yet other than Scott talking about it loads on syntax :) but looking forward to helping out where I can.

On Mon, 29 Oct 2018 at 19:18, Charlotte Fereday notifications@github.com wrote:

Thanks for the interesting comments & input @jsjoeio https://github.com/jsjoeio @eddiejaoude https://github.com/eddiejaoude @NathanGloyn https://github.com/NathanGloyn @felipesere https://github.com/felipesere @Whatapalaver https://github.com/Whatapalaver - really helpful! I will try it out with Gatsby first & can always change if it turns out to not be working. Thanks 👍

— You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub https://github.com/charlottebrf/coder-newbie-advice/issues/39#issuecomment-434043926, or mute the thread https://github.com/notifications/unsubscribe-auth/ANFcUQIudDxX5xztrhURJGshph4NF6vmks5up1SEgaJpZM4X-NVp .

[alaskaa]

Sorry to be so late to the party! Been busy all day yesterday.

Seems like some of the technical questions have been discussed a little bit so I'll focus on the designs a bit.

I think the first four columns could almost be restructured a little bit. Bootcamps and meetups are ultimately sub columns of countries right? So they could appear once you select a country. Online on the other hand is completely unrelated and available for anyone anywhere. So maybe we could make this distinction a little more clear :)

Tags are also a great idea and I think people generally like them for searching. Are you planning on making users tag resources? Or would the tagging be something we decide on at the start? Really curious where you're going with this!

Amazing idea to put it out there for people to use and search with as well, will furthermore increase visibility and will be a great resource to share at events like Codebar & CF:G too!

[charlottebrf]

I don’t have much input on anything spoken about so far, and I don’t know anything about gatsby yet other than Scott talking about it loads on syntax :) but looking forward to helping out where I can. … On Mon, 29 Oct 2018 at 19:18, Charlotte Fereday @.***> wrote: Thanks for the interesting comments & input @jsjoeio https://github.com/jsjoeio @eddiejaoude https://github.com/eddiejaoude @NathanGloyn https://github.com/NathanGloyn @felipesere https://github.com/felipesere @Whatapalaver https://github.com/Whatapalaver - really helpful! I will try it out with Gatsby first & can always change if it turns out to not be working. Thanks 👍 — You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub <#39 (comment)>, or mute the thread https://github.com/notifications/unsubscribe-auth/ANFcUQIudDxX5xztrhURJGshph4NF6vmks5up1SEgaJpZM4X-NVp .

Thanks for your input @jessicatee 👍

[charlottebrf]

Sorry to be so late to the party! Been busy all day yesterday.

Seems like some of the technical questions have been discussed a little bit so I'll focus on the designs a bit.

I think the first four columns could almost be restructured a little bit. Bootcamps and meetups are ultimately sub columns of countries right? So they could appear once you select a country. Online on the other hand is completely unrelated and available for anyone anywhere. So maybe we could make this distinction a little more clear :)

Tags are also a great idea and I think people generally like them for searching. Are you planning on making users tag resources? Or would the tagging be something we decide on at the start? Really curious where you're going with this!

Amazing idea to put it out there for people to use and search with as well, will furthermore increase visibility and will be a great resource to share at events like Codebar & CF:G too!

Some really great suggestions @alaskaa on the design, thanks so much. I think you make a good point actually about how to order the columns. I'll come back with another mock up design incorporating these suggestions & we can continue to discuss then.

I hadn't thought on making users tag resources, is that a way they could contribute to the project? I was thinking myself & whoever contributes would define the tags. Have you seen good examples where users themselves make the tags ?

[alaskaa]

You're welcome @charlottebrf ! Might be a little trickier to implement, but I think it would definitely aid the understanding of the user/person who is looking for the resources!

Mhhh - I think in many forum posts people can choose tags for what they need help with (for example SO), but same applies for medium posts (where I choose my own tags). Can only think of these of the top of my head, but there might be others!

I think we'd only need make sure that we'd deal with dupliicates/only let users choose predefined tags. Otherwise it might be a little hard to maintain. But very open to suggestions here!

[charlottebrf]

You're welcome @charlottebrf ! Might be a little trickier to implement, but I think it would definitely aid the understanding of the user/person who is looking for the resources!

Mhhh - I think in many forum posts people can choose tags for what they need help with (for example SO), but same applies for medium posts (where I choose my own tags). Can only think of these of the top of my head, but there might be others!

I think we'd only need make sure that we'd deal with dupliicates/only let users choose predefined tags. Otherwise it might be a little hard to maintain. But very open to suggestions here!

Thanks some interesting points here on the tags... I haven't started the website part of it yet, but once I do will open it up for contributions :)

[charlottebrf]

@catinthetap would be great to get your input on the above discussions about the idea for turning this into a website, probably using Gatsby

[charlottebrf]

Looks good. Might be easier to store the data in json or yml files instead of markdown?

Actually now thinking about using .yml by the way... haven't yet had time to start this but will v soon

[mikeshatch]

Coder Newbie has a better ring to it than Coder Newbie Advice. Another thing to consider is the existing site named codenewbie.org.

[charlottebrf]

Thanks that's a good point @mikeshatch ... so I have actually published this as a site now: http://coder-newbie.surge.sh however didn't share as I was hoping to make it look better first. It would be great to get any feedback contributors might have on this.

[empowerweb]

Charlotte,

This is a wonderful website! Thank you for making this. I'm in the U.S. so it's some different resources here, but you got all the int'l ones I'd recommend. I don't have anything to recommend except I have a StudioPress license and can send you any themes/instructions you want if you use WP. But, yeah, using other site builders is cool too.

Best, Dawn

On Tue, Mar 19, 2019 at 6:09 PM Charlotte Fereday notifications@github.com wrote:

Thanks that's a good point @mikeshatch https://github.com/mikeshatch ... so I have actually published this as a site now: http://coder-newbie.surge.sh however didn't share as I was hoping to make it look better first. It would be great to get any feedback contributors might have on this.

— You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub https://github.com/charlottebrf/coder-newbie-advice/issues/39#issuecomment-474603184, or mute the thread https://github.com/notifications/unsubscribe-auth/AYdUJ8C42E4gZM1To7PpwGzSB_7MDb2xks5vYV9EgaJpZM4X-NVp .[image: Web Bug from https://github.com/notifications/beacon/AYdUJwkaODrDmW-8sabD8mUF9Mln9OJ5ks5vYV9EgaJpZM4X-NVp.gif] {"api_version":"1.0","publisher":{"api_key":"05dde50f1d1a384dd78767c55493e4bb","name":"GitHub"},"entity":{"external_key":"github/charlottebrf/coder-newbie-advice","title":"charlottebrf/coder-newbie-advice","subtitle":"GitHub repository","main_image_url":" https://github.githubassets.com/images/email/message_cards/header.png ","avatar_image_url":" https://github.githubassets.com/images/email/message_cards/avatar.png","action":{"name":"Open in GitHub","url":"https://github.com/charlottebrf/coder-newbie-advice"}},"updates":{"snippets":[{"icon":"PERSON","message":"@charlottebrf in #39: Thanks that's a good point @mikeshatch ... so I have actually published this as a site now: http://coder-newbie.surge.sh however didn't share as I was hoping to make it look better first. It would be great to get any feedback contributors might have on this. "}],"action":{"name":"View Issue","url":" https://github.com/charlottebrf/coder-newbie-advice/issues/39#issuecomment-474603184 "}}} [ { "@context": "http://schema.org", "@type": "EmailMessage", "potentialAction": { "@type": "ViewAction", "target": " https://github.com/charlottebrf/coder-newbie-advice/issues/39#issuecomment-474603184", "url": " https://github.com/charlottebrf/coder-newbie-advice/issues/39#issuecomment-474603184", "name": "View Issue" }, "description": "View this Issue on GitHub", "publisher": { "@type": "Organization", "name": "GitHub", "url": " https://github.com" } } ]