ros-planning / moveit.ros.org

This is the MoveIt website

The MoveIt Website

The MoveIt website (http://moveit.ros.org/) is hosted on Github Pages using Markdown format. Changes to the main branch become immediately available online.

Images

Please compress images before loading them to the repo, we recommend https://tinypng.com/. High-resolution images from professional photographers will kill load times.

YouTube Videos

Please use https://www.youtube-nocookie.com/ instead of https://www.youtube.com/. Explanation here.

Build Locally on Ubuntu

Will install Ruby, and Jekyll, build the website, and server the website on localhost:

./build_locally.sh

If the dependencies are already installed (you've already run the previous command locally):

./build_locally.sh noinstall

If Jekyll is for some reason still running in the background, kill to prevent port conflicts:

pkill -9 -f jekyll

Run Build Tests Locally

Will check all links are valid, etc:

./build_locally.sh check

moveit.ros.org's Issues

Trim image size

See screenshot

Update World MoveIt Day 2019 blog post

Please update the existing blog post:
https://moveit.ros.org/moveit/ros/2019/07/31/world-moveit-day-2019.html

See the following doc, for changes requested:
https://docs.google.com/document/d/1fnK72OOAybvv-EP-Vea3DCp0MfzrTrEriS9PBIjiHWY/edit#

Remove note about ros-noetic-fcl after next sync

drop master branch

This repository should really only have one branch, so either gh-pages or master should be dropped.

broken links

Travis recently reports two broken links:

• ./_site/documentation/concepts/index.html
  • External link http://www.orocos.org/kdl failed: 404 No error
• ./_site/events/world-moveit-day-2018/index.html
  • External link https://www.evite.com/event/030AUF672VIUQMVHQEPI2KHJ4AIZNA/activity failed: 403 No error

These are rather old links, which became unavailable only recently. Somebody should replace or remove them.

clang format on Ubuntu18

It seems that clang-format-3.8 is not available on Ubuntu 18.04 with the following command.

sudo apt-get install python-wstool python-catkin-tools clang-format-3.8

We will want to update the instructions on the install from source page

Update all youtube links to be youtube-nocookie

Several of the blog posts from the last year (including one I posted) do not follow the protocol of using youtube-nocookie for embedding.

• 2020-02-25-mtc
• 2020-06-09-moveit2-robotic-application (media link)
• 2020-08-04-moveit-melodic-release
• 2020-09-09-moveit2-servo (media link)
• 2020-09-10-ompl-constrained-planning-gsoc (media link)
• 2020-11-24-ros-world-2020

There is also a link to the youtube iframe api in the footer which might be dropping a cookie, but I'm not sure if we can get rid of it.

Replace homepage banner link

Replace homepage banner link. Change from MoveIt Workshop to World MoveIt day page.

Text: "Signup for World MoveIt Day 2019 on Nov. 20th!"

For this to work as moveit.ros.org it needs a CNAME file

https://help.github.com/articles/adding-a-cname-file-to-your-repository/

Until this is done moveit.ros.org will be a 404

Link Press Kit in menu

Currently, the press kit is not linked in a menu (I'd prefer about) as far as I can see. The only reference I found on the page itself was at the bottom of the code style guide page.

https://moveit.ros.org/install/docker/ - Missing link

https://moveit.ros.org/install/docker/

In the section

Running MoveIt Containers
To use Rviz (and other GUIs), you probably want to set up hardware acceleration for Docker as described here.

here is not a link; which I guess it should be?

"Related projects" page

It would be nice to have a page collection of related code projects/plugin on the website.

Some random packages that come to my mind off the top of my head:

https://github.com/ros-industrial/industrial_moveit
https://github.com/TAMS-Group/move_group_online_collision_predictor
https://github.com/TAMS-Group/bio_ik
https://bitbucket.org/traclabs/trac_ik
https://github.com/davetcoleman/moveit_grasps
https://github.com/ros-planning/moveit_visual_tools
https://github.com/ros-planning/moveit_task_constructor
https://github.com/ros-industrial-consortium/descartes

Events page

We need to remove the two events on the Contribute menu (WMD and MW) and instead have a single link for 'Events' on that menu

That page will then go to a 'filtered' blog page, that only shows posts that have the 'events' tag used

In this way, we can write blog posts for events that show up both on the blog and on the events page, all at once

Switch to main branch

Once we're low on open PRs for this repo, I think we should switch the name of the 'master' branch over per moveit/moveit#2213

Add left side nav to pull request page

We'd like to create a left side nav similar to the install page but for technical guidelines. The nav would include for now:

• Contributing Pull Requests
• Reviewing Pull Requests (separate these pages)
• Release Process
• Code Style

html-proofer travis broken

Our travis builds seem broken for the website, for example

An error occurred while installing activesupport (5.0.0.1), and Bundler cannot continue
Make sure that gem install activesupport -v '5.0.0.1' succeeds before

@mintar think you can look at this?

Switching to master branch

I believe historically Github pages required you host your website from gh-pages branch, but more recently they support a regular old master branch. Because we use master for everything else on the MoveIt project including the tutorials, it would be nice to do the same for our website.

Notably, we use Github pages for picknik.ai and we use a master branch there, and it works great.

The only side effect of this switch will be that we have to retarget open PRs. However, I just went through and merged most of them.

fyi @JafarAbdi @guilesn @robroboto

Force-Push to website repo

I'd like for us to force-push the master history of this repo to remove 51 MB of images that were accidentally committed into the git history:
#250

@henningkayser is currently removing these images on HEAD
#270

But we should also erase it from the history using a tool like:

java -jar bfg.jar --strip-blobs-bigger-than 2M

source

Anyone object? we'd need to merge/close all other current PRs first.

World MoveIt Day Updates

Germany, Hamburg, Universität Hamburg

• Organizer: Group TAMS

India, Chandigarh, Embedded Group of UIET, Panjab University

• Organizer: Pallav Bhalla / Ankur Bhatia

India, New Delhi, Cluster Innovation Centre, Delhi University, New Delhi, India

• Organizer: Ridhwan Luthra

Japan, Tokyo, OMRON SINIC X

• Organizer: Felix von Drigalski
• Event details

Singapore, Advanced Remanufacturing and Technology Centre (ARTC) / ROS-Industrial Asian Pacific
-Organizer: Sheila Suppiah

• Event details

USA, San Antonio, Southwest Research Institute / ROS-Industrial Consortium Americas

• Organizer: Jorge Nicho

USA, Boulder, PickNik Robotics

• Organizer: Rob Coleman
• Event details

USA, CA, Union City, Vicarious

• Organizer: Peter So

USA, CA, San Jose, Fetch / ROS by the Bay

• Organizer: Alexander Moriarty

USA, ID, Pocatello, Idaho State University

• Organizer: Omid Heidari

Remove note about clang-format-3.9

In the instructions for using clang-format-10 there is a note about clang-format-3.9 that should probably be removed.

missing Scene_Format

Hi
Where can I found scene file format description. It seems there was a wiki page at http://moveit.ros.org/wiki/Scene_Format , but it is missing right now.

c.f. https://gist.github.com/awesomebytes/6951f6aa8b96779ece57fbbc12c02992
c.f. https://groups.google.com/forum/#!topic/moveit-users/RqCFJkLSs6A

@Moirai

[Feature] Use Jekyll collections for listing items on webpages

Setup this plugin https://jekyllrb.com/docs/collections/

To list out the following types:

• People (maintainers / core contributors / alumni)
• Robots
• Related Projects (?)

Benefits: alphabetization easier, changing People's status easier, more stable code

Ability to link to specific install type

Would be great to have the binary install page allow a hyperlink to a particular operating system instruction set. Right now it always defaults to Ubuntu 18.04, but ideally we could have a url such as install?type=windows that would open the Windows section of that page (by default hidden by JavaScript).

Working on blog post with Microsoft and this need came up...

Add date to blog posts

After opening a blog post, the date is not visible at the top

For example: https://moveit.ros.org/moveit/ros/2019/09/19/moveit-workshop-macau.html

I would like it to have the date like we do for picknik's website:
https://picknik.ai/moveit/ros/2019/09/20/moveit-workshop-macau.html

@JafarAbdi

Information on "Robots" page might be out-of-date

e.g. Latest package for PR2 is Hydro, which is simply wrong (Indigo is the answer).

The info is maintained in this repository instead of automatically pulling in from e.g. each robot's package.

Updates for MoveIt homepages

@JafarAbdi
Please see proposed changes here: https://docs.google.com/document/d/1DevLkDKQrimcT7XENEVB3_hTQvUF9Mm84B6_k0wBUZk/edit?usp=sharing

World MoveIt Day update

• Change Organizer for Fetch / ROS by the Bay location from "Alexander Moriarty" to "Amel Ali"
• SWRI
  Add Event Link: https://www.eventbrite.com/e/world-moveit-day-2019-san-antonio-tickets-72393064605
  Add logo to sponsors section:
  https://drive.google.com/file/d/14J5mDx5hY8hBlDT_vpJJfY2wJ9U9XJNB/view?usp=sharing

MoveIt Homepage link broken

http://www.moveit.ros.org/ is broken

Add a feed for RSS aggregators

Github pages has support for this now: https://help.github.com/articles/atom-rss-feeds-for-github-pages/

Planet.ros.org's moveit feed is 404 at the moment.

Blog Post for MoveIt Workshop 2019 Macau

Please see: https://docs.google.com/document/d/1wi4dFielGWFvSPNFCEEHofGFwGGyYNW6XGAUQ4j_J-k/edit?usp=sharing

@JafarAbdi

Design changes for People Page

@JafarAbdi is working with Peter to implement this

Design changes for Install Pages (Binary, Source, Docker)

Add author to blog posts

Would be great to give credit to those who write content for the blog - this can be done easily using jekyl semantic data. PickNik has a good example that @auman66 can easily see the source code for.

Fix Travis

Still seems broken: https://travis-ci.org/ros-planning/moveit.ros.org

@mintar ?

Improve visual appear of installation pages

Seems we should simplify the binary and source installation pages somehow:

• improved colored boxes?
• dynamic accordion?
• table of contents?

what do other projects do?

Motion planning capitalization on the front page

Motion planning should have a capital 'P'

Ruby version update

./build_locally.sh doesn't work on Ubuntu 16.04 with the packaged version of Ruby. These instructions worked to install the required version: https://linuxize.com/post/how-to-install-ruby-on-ubuntu-18-04/

Should we link to (or describe) how to update ruby in the readme instead of the notice about 16.04 holding us back?

Migrate moveit-users to discourse.ros.org?

Not really moveit.ros.org topic but I didn't want to pullute developers repo moveit for an admin topic like this.

moveit-users mailinglist is still using standalone groups.google.com. As lots of mailinglist has shifted to discourse.ros.org, do we want to do that?

Personally I'm +1 for migration; being able to find discussions at one place makes search far easier

(even with Google, e.g. I had to spend a few minutes to find the recent call-for-montage thread. If it were on discource I could've found in instantly).

If we want then what's the step? Maybe we'll just ask Tully?

Improve blog post date style

The date is too close to the image (add more padding).
Let's also make it have the exact css style as the picknik website:

Inconsistent menus in documentation

This site seems to be the main entry point for moveit docs: https://moveit.ros.org/documentation/
But when you open the docs menu on the top of the website, it looks differently:

The menu of the top has a different order of elements when compared to the page. And the point Planners is even missing from the page.

switch to https

Github pages now supports https for custom domains. It should be possible to switch this site over to use https by default and have github redirect all users to https. This will likely require a brief audit of all links and resources but otherwise the site looks like it's mostly compliant already. You can check any existing page by just typing https:// in front of each url.

Tweak MoveIt Feedback Form

The modal box is not wide enough, please expand css / html:

Also nit, but don't you think the feedback form would look more professional if all radio and checkbox options had first letter capitalized?S

style update for c++11

We should account for C++11 in our style guideline.

ad tracking on moveit.ros.org

Browsing the site I noticed that my browser is blocking doubleclick on moveit.ros.org

https://gist.github.com/tfoote/3dfcbfc00f9775a55335b6e5a3d6f968

It seems to be related to an embedded video player.

Adjust contribute menu and change homepage announcement

1. Add MoveIt Workshop to the "Contribute" menu of moveit.ros.org
   -Use text "MoveIt Workshop"
   -List above "World MoveIt Day"
   -Links to https://moveit.ros.org/moveit/ros/2019/09/19/moveit-workshop-macau.html

2. Replace the MoveIt homepage announcement (currently about World MoveIt Day) with an announcement about the MoveIt Workshop.
   -Use the text "First annual MoveIt Workshop is November 2!
   -Add link to https://moveit.ros.org/moveit/ros/2019/09/19/moveit-workshop-macau.html

Instruction for getting notification from answers.ros.org is not working

From #78 (comment) by @v4hn

I just tried to follow your howto, but I keep getting a red box saying "must be unicode, not str" whenever I enter "moveit" (or anything else) into the input field for interesting tags.

Hm, I see the same. Filed ros-infrastructure/answers.ros.org#140

We should hold an announcement #78 (comment) before this issue gets fixed @IanTheEngineer.

Change external links to open in new window

All links to sites outside of moveit.ros.org should have a target="_blank" in the <a href...>so they open in a new tab.

Add RSS feed to website

I think this would work:

https://github.com/snaptortoise/jekyll-rss-feeds

So that moveit can be rendered again on planet-ros

moveit-users ML improvement

Not about website at all but let me be open here.

For both of the following Google Groups has an option to realize.

• There's no link to the discussion printed at the end of each email.
• In the subject line, there's no info about the list (name of the list, ID of the thread etc.). Only the subject the sender filled is printed. This makes it difficult for me if the email is via ML or individual one.

I think some of the current moveit active maintainers should also get admin rights.

Installation steps missing for Melodic Morenia on the installation page

The beta version of Moveit! has been released for ROS Melodic (yay!) according to the page:
http://moveit.ros.org/moveit!/ros/2018/05/23/firstmelodicrelease.html

But the installation guide webpage ( http://moveit.ros.org/install/) doesn't contain the instructions for installation on ROS Melodic.