Felipe Schenone.jpg

Page MediaWiki:TemplateDatabox.js has no content.

Hi! My name is Felipe, I'm a freelance web developer from Buenos Aires, Argentina, specialized in MediaWiki and currently working for the Appropedia Foundation to improve Appropedia. If I made a mistake somewhere, please be cool, let me know and I'll fix it asap, thanks!

Content created

Subpages

Time tracking

  • 2 hours - UX/UI and user flow
  • 2 hours - Extensions
  • 5 hours - Search and homepage
  • 7 hours - Templates and maintenance
  • 11 hours - Debug and fix MediaWiki upgrade
  • 3 hours - Normalize file pages
  • 5 hours - Talks, chats, calls, etc

Documentation tips

  • Important stuff first! - Readers may stop reading anytime, so increase the chances they take away the important bits by putting them at the start of each page, section or paragraph.
  • Write an intro - And include a main image whenever possible. This will be the first and often only thing users will read. It's also likely to be the snippet shown in search engines.
  • Keep it simple - Avoid styling and focus on content. Plain text in standard format is usually the most effective and compatible across devices.
  • Let it grow organically - Start by writing some text. When it grows too big, break it into sections. When they grow too big, break them into subsections. When they grow too big, break them into separate pages (avoid sub-subsections) and leave an excerpt or link behind.
  • Avoid walls of text - Except in "terminal nodes". Use short paragraphs and "structural" elements like lists, tables, section, subsections, images, etc. Doing so makes the page easier to scan in search of what we're interested in.
  • Use item summaries - Like it's done in this list.
  • Avoid excessive nesting - Be it of subsections, lists or any other element, excessive nesting usually signals the need to rethink or restructure the content.
  • Make every word count - It's often possible to shorten a sentence by carefully selecting or shifting words. Repeat for several sentences and you can shorten a paragraph by a line or two. Do that for several paragraphs and you can shorten a page considerably. Excellence is in the details!
  • Paragraphs are semantic units - Each paragraph should be more or less independent.

Site sustainability tips

  • Actively fight complexity and work towards simplicity
    • Less templates, more content!
    • Avoid custom namespaces (given the extremely diverse nature of pages in the main namespace of Appropedia, there should be no need for custom namespaces)
    • Merge related pages to have fewer, better ones
  • Prefer well-supported extensions, especially Wikimedia-supported ones
  • Keep MediaWiki updated only to the latest LTS version and never modify the source code
  • Convention over configuration
  • Use modern web standards and structured data for rich results
Cookies help us deliver our services. By using our services, you agree to our use of cookies.