48b652cdc6a5d76ecc2a431c1a21d9d3e0b4e513
[fsf-giving-guide.git] / Guidelines.md
1 # Guidelines for future use
2 ---
3 ## Images:
4
5 * If it's a logo then ALWAYS export the images from its VECTOR (.svg, .eps, .pdf) source. If a vector source isn't available, use a very large image and scale it down.
6
7 * Do not put a logo next to a product or vice-versa, Always use images with the same nature (i.e. product versus product; logo versus logo)
8
9 * Charities' logos should be exported to 580px × 580px, transparent PNG
10
11 * Products' images, "good" or "naughty" should be put inside transparent, square PNG files at 350px × 350px, and a padding consistent with existing images.
12
13 ## BUY/GET button
14
15 * Copy the entire block of code including the two lines for comments before and after the Divs.
16
17 * Paste it just after the **h5** line.
18
19 * Append a unique string to the `id` `href` `aria-controls` of the **a** elements, as well as the `id` of the next div and the content of `document.getElementById('...')` so that all have the same text. Example: `get-iem-smartphone` `get-item-compact` ...
20
21 * Change the content of the Anchor link **a** and its `href` attributes to link to different sellers.
22
23 * If the product has only one source use this code instead:
24
25 `<a class="btn get-item" role="button" href="#">BUY</a>`
26
27
28 ## General Best Practices
29
30 * Resist the urge to add another list-element **li** to announce a SALE, a BONUS, or anything unrelated to being a PROS or CONS. Instead use the SALE triangle, and Bootstrap's *alert* (Check its documentation, or existing code if unsure)
31
32 * Avoid using very long titles as they tend to wrap into multiple lines on mobile devices. Be concise.