FacilGuide

Utilities for building multilingual content with FacilGuide. The platform publishes simplified technology guides designed for older adults who are learning to use smartphones, apps, and online services for the first time. All content is available in five languages: English, Spanish, French, Portuguese, and Italian.

gem install facilguide

Or add to your Gemfile:

gem 'facilguide'

FacilGuide's content is built around a five-language matrix. The gem exposes language codes and their native labels for use in your own multilingual tooling:

require 'facilguide'

FacilGuide::LANGUAGES.each do |code, label|
  puts "#{code} - #{label}"
end
# en - English
# es - Espanol
# fr - Francais
# pt - Portugues
# it - Italiano

# Generate a URL for a specific language edition
lang = "es"
path = "#{FacilGuide::BASE_URL}/#{lang}/"
puts path  # => "https://facil.guide/es/"

# Iterate all language roots
FacilGuide::LANGUAGES.keys.map { |code|
  "#{FacilGuide::BASE_URL}/#{code}/"
}

The platform organizes content into categories that reflect common tasks seniors encounter:

FacilGuide::GUIDE_CATEGORIES.each { |cat| puts cat }
# smartphones, messaging, video-calls, social-media,
# email, online-safety, photos, streaming, shopping

info = FacilGuide.info
puts info[:name]            # => "FacilGuide"
puts info[:language_count]  # => 5
puts info[:audience]        # => "seniors and older adults"

Guides follow a consistent format: large text, numbered steps with screenshots, and plain vocabulary. Each guide avoids jargon -- "tap the green phone icon" instead of "initiate a VoIP session." The goal is zero assumed knowledge. Topics range from setting up WhatsApp to recognizing phishing emails, structured so that each guide can be completed in under ten minutes.

• FacilGuide -- simplified tech guides in 5 languages
• English Guides -- browse the English edition
• Source Code

MIT