A few high-level things to know

We are a Ruby on Rails app

Ruby on Rails is a web framework heavy on conventions over configuration. All else equal, we should try to follow Rails convention. We are currently on version 5.2.3, due for an upgrade to 6.x.x.

We cache many content pages on the edge

To decrease loading time, we use edge-caching extensively. Taking advantage of edge-caching means that we do not go all the way to the server to render every page. Therefore, on pages that are cached we don't have access to helper methods like current_user. A page is edge-cached through our CDN (Fastly) if the controller contains this line for the relevant action:

before_action :set_cache_control_headers

We also use server-side caching: Rails caching. If you see Rails.cache or <%= cache ... %>, this is code affected in production by caching.

We use inline CSS and deferred scripts for usage performance improvements

To avoid blocking the initial render, we frequently write critical CSS inline, and we use the defer attribute to accelerate page loads. This practice results in a faster page load, and doesn't leave users waiting on heavy assets. However, this practice limits our ability to manipulate layout with JavaScript. As a rule, you should avoid relying on JavaScript for layout when working on DEV.

We attempt to reduce our bundle size

We use PreactJS, a lightweight alternative to ReactJS, and we try to reduce our bundle size with dynamic imports.

Worst technical debt

The most widespread elements of technical debt in this application reside on the frontend. We use both the "old" approach (files in the /assets folder) and "new" approach (files in the app/javascript folder) for loading JavaScript into our Rails app.

We also have overgrown and inconsistent CSS. This is an area we'd love to see contributions from the community.

We also have inconsistencies and issues with how we bust caching on the edge. Ideally, we could practice resource-based purging as described in the Fastly Rails docs, but we bust specific URLs via CacheBuster.

The algorithm behind the feed

The home feed is based on a combination of recent collective posts that are cached and delivered the same to everyone in the HTML, and additional articles fetched from an Algolia index after page load. To determine which posts a user sees, they are ranked based on the user's followed tags, followed users, and relative weights for each tag. Additional fetched articles also follow this general pattern.

Currently, the top post on the home feed, which must have a cover image, is shared among all users.

Inter-page navigation

DEV uses a variation of "instant click," which swaps out page content instead of making full-page requests. This approach is similar to the one used by the Rails gem Turbolinks, but our approach is more lightweight. The library is modified to work specifically with this Rails app and does not swap out reused elements like the navigation bar or the footer. The code for this functionality is viewable in app/assets/javascripb/base.js.erb.

There are a few caveats regarding this approach. Using our approach means a non-trivial amount of functionality is reloaded on page change. A similar amount of reloading occurs when using window.InstantClick.on('change', someFunction). This results in code that looks something like this:

1
2
initPreview();
window.InstantClick.on('change', initPreview);

In some circumstances, this practice means the developer should pay special attention to the declaration of variables and functions. JavaScript may behave differently than expected.

Abstracting and removing these caveats is a long term goal, and contribution on that front is welcome!

General app concepts

Articles (or posts)

Articles are the primary form of user generated content in the application. An Article has many comments and taggings through the acts-as-taggable gem, belongs to a single user (and possibly an organization), and is the core unit of content.

Comments

Comments belong to articles or other content (they are generally polymorphic). They belong first and foremost to the user in our design, which is reflected by the URL (/username/tag-slug), but they are present in communal areas of the application. They are threaded, but they flatten out gradually to avoid infinitely branching threads.

Tags

Tags are used to organize user generated content. Each tag has a set of rules which are used for moderation. Each tag is a de facto community complete with community moderators.

Some tags behave as "flare," highlighting certain articles when viewed from the index page. Tags that act as "flare" are defined in the FlareTag object. In cases of multiple flare tags, the tag displayed is determined by its hierarchy.

ClassifiedListings (or listings)

Classified listings are similar to posts in some ways, but with more limitations. They are designed to be categorized into market areas. They also make use of tags.

Credits

Credits are the currency of the platform which users can use to buy listings. The functionality of credits may be expanded in the future.

Organizations

Users can belong to organizations, which have their own profile pages where posts can be published etc. This can be any group endeavor such as a company, an open source project, or any standalone publication on DEV.

Reactions

Hearts, unicorns, and bookmarks. Reactions are the medium for displaying appreciation for content. Bookmarks have the unique functionality of saving an article in the user's reading list.

Follows

How a user keeps track of the tags, users, or articles they care about. Follows impact a user's home feed and notifications.


This is far from a complete view of the app, but it covers a few core concepts.