Taken from macports.org improvements

Suggestions:

A. DESIGN

1. Consistency between macports-www, /news (macports.github.io) and macports-guide

2. Support mobile devices (responsive layout, optimise navigation)

3. Modernise assets (logo/favicons/apple-touch-icon)

B. CONTENT

1. Improve navigation

  • reduce the number of navigation links

2. Improve website copy

  • remove/summarize content that overlaps with the documentation (e.g.: /install.php)

3. Improve UX for first time users

  • keep the homepage simple:

A short sentence describing 'what does MacPorts do'
Ports search bar
Install [link]
Getting Started/Quick Start [link]

C. FUNCTIONALITY

  1. Use the same system/repo for macports-www, /news (macports.github.io) and macports-guide (same writing format/publishing workflow)
  2. Replicate 'Available Ports' functionality (or integrate the page - https://github.com/macports/macports-www/pull/14#issuecomment-489356921)
  3. Offer the option to search ports from the homepage
  4. Support content translation
  5. Improve accessibility

Content structure:

Draft document: https://hackmd.io/s/BJwfLOToN


Drafts:

1: 5 May 2019 Design Prototype #1

Image Not Showing Possible Reasons
  • The image file may be corrupted
  • The server hosting the image is unavailable
  • The image path is incorrect
  • The image format is not supported
Learn More →

Image Not Showing Possible Reasons
  • The image file may be corrupted
  • The server hosting the image is unavailable
  • The image path is incorrect
  • The image format is not supported
Learn More →

Image Not Showing Possible Reasons
  • The image file may be corrupted
  • The server hosting the image is unavailable
  • The image path is incorrect
  • The image format is not supported
Learn More →

Image Not Showing Possible Reasons
  • The image file may be corrupted
  • The server hosting the image is unavailable
  • The image path is incorrect
  • The image format is not supported
Learn More →

Image Not Showing Possible Reasons
  • The image file may be corrupted
  • The server hosting the image is unavailable
  • The image path is incorrect
  • The image format is not supported
Learn More →

  • Notes:
    • responsive layout
    • same website for macports-www, /news (macports.github.io) and macports-guide
    • no content changes
    • missing functionality ('Available Ports')

2: 19 May 2019 Design Prototype #2

Image Not Showing Possible Reasons
  • The image file may be corrupted
  • The server hosting the image is unavailable
  • The image path is incorrect
  • The image format is not supported
Learn More →

Image Not Showing Possible Reasons
  • The image file may be corrupted
  • The server hosting the image is unavailable
  • The image path is incorrect
  • The image format is not supported
Learn More →

Image Not Showing Possible Reasons
  • The image file may be corrupted
  • The server hosting the image is unavailable
  • The image path is incorrect
  • The image format is not supported
Learn More →