nerves-project / nerves-project.github.io Goto Github PK

Hey!

Not sure if github changed the pages format on your or something, but there's a lot of links to .html pages that are dead until you go to the url and replace the .html with / e.g. http://nerves-project.org/learn/prepare.html => http://nerves-project.org/learn/prepare/

This causes a fair bit of confusion on the learning page because basically all the content appears dead at first glance.

I'd open a PR but I'm not super familiar with github pages stuff and I don't want to miss anything, sorry!

Allow users to submit Nerves related articles to be displayed. Initially, I think this should just be for external articles and we simple display a list of title, author, and link

NervesTips is currently run with https://github.com/jjcarstens/nerves_tips.

With the new site, we can now host it ourselves from the same source so we should migrate it to here

Much of the site is designed to encourage community contributions (i.e. videos, articles, etc) - We should make a PR template for each contribution type that can be linked to in the website. When a user clicks to create a PR to add, the template will instruct how to do so

The set-up instructions in the README instructing the use of Ruby 2.0 are unworkable at the moment, since some transitive dependency is pulling in ActiveSupport 5.0 which actually requires Ruby 2.2+:

$ bundle install
Fetching gem metadata from https://rubygems.org/
Fetching version metadata from https://rubygems.org/
Fetching dependency metadata from https://rubygems.org/
Resolving dependencies...
Rubygems 2.0.14 is not threadsafe, so your gems will be installed one at a time. Upgrade to Rubygems 2.1.0 or higher to enable parallel gem installation.
Installing concurrent-ruby 1.0.2
Installing i18n 0.7.0
Installing minitest 5.9.0
Installing thread_safe 0.3.5
Installing addressable 2.4.0
Installing coffee-script-source 1.10.0
Installing execjs 2.7.0
Installing colorator 0.1
Installing ffi 1.9.14 with native extensions
Installing multipart-post 2.0.0
Installing gemoji 2.1.0
Installing net-dns 0.8.0
Installing public_suffix 1.5.3
Installing sass 3.4.22
Installing rb-fsevent 0.9.7
Installing kramdown 1.11.1
Installing liquid 3.0.6
Installing mercenary 0.3.6
Installing rouge 1.11.1
Installing safe_yaml 1.0.4
Installing jekyll-feed 0.5.1
Installing mini_portile2 2.1.0
Installing pkg-config 1.1.7
Installing jekyll-paginate 1.1.0
Installing jekyll-sitemap 0.10.0
Installing terminal-table 1.6.0
Using bundler 1.12.5
Installing tzinfo 1.2.2
Installing coffee-script 2.4.1
Installing ethon 0.9.0
Installing rb-inotify 0.9.7
Installing faraday 0.9.2
Installing jekyll-sass-converter 1.3.0
Installing nokogiri 1.6.8 with native extensions
Installing activesupport 5.0.0

Gem::InstallError: activesupport requires Ruby version >= 2.2.2.
Installing jekyll-coffeescript 1.0.1
Installing typhoeus 0.8.0
Installing listen 3.0.6
Installing sawyer 0.7.0
An error occurred while installing activesupport (5.0.0), and Bundler cannot continue.
Make sure that `gem install activesupport -v '5.0.0'` succeeds before bundling.

$ ruby2.0 --version
ruby 2.0.0p384 (2014-01-12) [x86_64-linux-gnu]
$ gem2.0 --version
2.0.14
$ bundler --version
Bundler version 1.12.5

The above was on Ubuntu 14.04.4 LTS with the system ruby2.0 and ruby2.0-dev packages installed, and after sudo gem2.0 install bundler. (No RVM, as it is orthogonal to the issue.)

The dependency hell is no doubt properly an upstream GitHub Pages and/or Jekyll issue, but nonetheless the README's instructions here need updating somehow or another so as to enable potential contributors to get set up with the repository locally.

GitHub deprecated the .com version years ago I think. It doesn't seem like this breaks anything, but I wonder if we should rename the repository just in case that changes in the future.

Just a content issue: points to relx.org, seems as though it should point to https://github.com/erlware/relx

Request from @axelson - Add a simple breadcrumb when in a specific resource. (i.e. resources / videos)

@mobileoverlord's talk at ElixirConf EU was especially interesting to people (like me) that were interested in Nerves but had wanted a build toolchain closer to other Elixir projects (eg, using mix). To help with project momentum & uptake I think it probably makes sense to update the website content in a few places I noticed trying to get started:

• An addition to http://nerves-project.org/news/ mentioning the new approach / Justin's talk
• A links/embedding to the talk from ElixirConf EU: video | slides at http://nerves-project.org/watch/
• Updates to http://nerves-project.org/learn/ describing the new build ecosystem