Umherirrender has uploaded a new change for review.

  https://gerrit.wikimedia.org/r/110637

Change subject: Document $wgResourceLoaderMaxage in DefaultSettings.php
......................................................................

Document $wgResourceLoaderMaxage in DefaultSettings.php

To have a start and to remove the todo.

Change-Id: I62421f1399c0f3e77238c39322028b969c0e925f
---
M includes/DefaultSettings.php
1 file changed, 12 insertions(+), 3 deletions(-)


  git pull ssh://gerrit.wikimedia.org:29418/mediawiki/core 
refs/changes/37/110637/1

diff --git a/includes/DefaultSettings.php b/includes/DefaultSettings.php
index 326a1c2..872e41d 100644
--- a/includes/DefaultSettings.php
+++ b/includes/DefaultSettings.php
@@ -3142,14 +3142,23 @@
 
 /**
  * Maximum time in seconds to cache resources served by the resource loader.
+ * Used to set last modified headers (max-age/s-maxage).
  *
- * @todo Document array structure
+ * Following options to distinguish:
+ * 'versioned': Used for modules with a version, because changing version
+ *              numbers causes cache misses. This has normally long expiry 
time.
+ * 'unversioned': Used for modules without a version to progate changes
+ *                quickly to clients. Also used for modules with errors to
+ *                recover quickly. This has normally short expiry time.
+ *
+ * Expiry time for the options to distinguish:
+ * 'server': Squid/Varnish but also any other public proxy cache between the
+ *           client and MediaWiki.
+ * 'client': On the client side (e.g. in the browser cache).
  */
 $wgResourceLoaderMaxage = array(
        'versioned' => array(
-               // Squid/Varnish but also any other public proxy cache between 
the client and MediaWiki
                'server' => 30 * 24 * 60 * 60, // 30 days
-               // On the client side (e.g. in the browser cache).
                'client' => 30 * 24 * 60 * 60, // 30 days
        ),
        'unversioned' => array(

-- 
To view, visit https://gerrit.wikimedia.org/r/110637
To unsubscribe, visit https://gerrit.wikimedia.org/r/settings

Gerrit-MessageType: newchange
Gerrit-Change-Id: I62421f1399c0f3e77238c39322028b969c0e925f
Gerrit-PatchSet: 1
Gerrit-Project: mediawiki/core
Gerrit-Branch: master
Gerrit-Owner: Umherirrender <umherirrender_de...@web.de>

_______________________________________________
MediaWiki-commits mailing list
MediaWiki-commits@lists.wikimedia.org
https://lists.wikimedia.org/mailman/listinfo/mediawiki-commits

Reply via email to