Static content for https://spidermonkey.dev/

This website is a landing page connecting to resources useful for people working on or with the Mozilla SpiderMonkey JavaScript Engine.

Note: Documentation itself should be kept in-tree when possible and linked to from here.

• Create an entry in _posts, with title layout of YYYY-MM-DD-title.markdown
• Add a frontsmatter:

---
layout: post
title: "My Title"
date: 2021-05-03 09:30:00 +0700
---

To contribute changes to https://spidermonkey.dev/, submit a pull request. It will be reviewed by someone in the "Website Reviewers Group". There isn't a formal policy for what is needed for a review, but we do want to second set of eyes checking for typos, phrasing, and other editorial things.

Material for the website is focused around communication between the SpiderMonkey team and community (such as "What chat service can the team be found on this year?"). Low-level technical details on using SpiderMonkey usually are best documented in the source as [SMDOC] comments, and version-specific information (such as build, debug, and testing information) is best documented on https://firefox-source-docs.mozilla.org/.

Ruby and Bundler must be installed. On Ubuntu the following should work (replace $REPO_URL with the GitHub repository URL):

$ sudo apt-get install git ruby bundler zlib1g-dev
$ git clone $REPO_URL spidermonkey.dev
$ cd spidermonkey.dev
$ bundle install --path vendor # If this complains about Bundler version, see below.
$ bundle exec jekyll serve

This will start a webserver on localhost. It rebuilds the website in the background when you update the markdown files.

Ensure you're using a modern ruby. Consider using a ruby version manager like rbenv which will allow you to freely change versions, even just for this directory

If bundle install fails with an error about the Bundler version, do what it suggests, for example:

$ gem install bundler:2.0.2

If you get Error: undefined method []' for nil` make sure you are using ruby <= 3.2.2(jekyll >= 4.3.2 requires ruby >= 3.3.0)

• Failure to build native extension

  sudo xcode-select -s /Applications/Xcode.app/Contents/Developer
  sudo xcodebuild -license
  

• If you get cannot load such file -- erb (LoadError)

  This is caused because Ruby package doesn't require ruby-erb

  You can fix it by installing the ruby-erb package

  sudo pacman -S ruby-erb
  

The domain spidermonkey.dev is managed by Mozilla IT.

Mozillia Employees: Changes for it can be done through the MozCloud intake process.