Issue #1234830 by beejeebus, oriol_e9g, schildi: Fixed cache_menu(): huge table size.
[project/drupal.git] / README.txt
1
2 CONTENTS OF THIS FILE
3 ---------------------
4
5  * About Drupal
6  * Configuration and features
7  * Appearance
8  * Developing for Drupal
9
10 ABOUT DRUPAL
11 ------------
12
13 Drupal is an open source content management platform supporting a variety of
14 websites ranging from personal weblogs to large community-driven websites. For
15 more information, see the Drupal website at http://drupal.org/, and join the
16 Drupal community at http://drupal.org/community.
17
18 Legal information about Drupal:
19  * Know your rights when using Drupal:
20    See LICENSE.txt in the same directory as this document.
21  * Learn about the Drupal trademark and logo policy:
22    http://drupal.com/trademark
23
24 CONFIGURATION AND FEATURES
25 --------------------------
26
27 Drupal core (what you get when you download and extract a drupal-x.y.tar.gz or
28 drupal-x.y.zip file from http://drupal.org/project/drupal) has what you need to
29 get started with your website. It includes several modules (extensions that add
30 functionality) for common website features, such as managing content, user
31 accounts, image uploading, and search. Core comes with many options that allow
32 site-specific configuration. In addition to the core modules, there are
33 thousands of contributed modules (for functionality not included with Drupal
34 core) available for download.
35
36 More about configuration:
37  * Install, upgrade, and maintain Drupal:
38    See INSTALL.txt and UPGRADE.txt in the same directory as this document.
39  * Learn about how to use Drupal to create your site:
40    http://drupal.org/documentation
41  * Download contributed modules to sites/all/modules to extend Drupal's
42    functionality:
43    http://drupal.org/project/modules
44  * See also: "Developing for Drupal" for writing your own modules, below.
45
46 APPEARANCE
47 ----------
48
49 In Drupal, the appearance of your site is set by the theme (themes are
50 extensions that set fonts, colors, and layout). Drupal core comes with several
51 themes. More themes are available for download, and you can also create your own
52 custom theme.
53
54 More about themes:
55  * Download contributed themes to sites/all/themes to modify Drupal's
56    appearance:
57    http://drupal.org/project/themes
58  * Develop your own theme:
59    http://drupal.org/documentation/theme
60
61 DEVELOPING FOR DRUPAL
62 ---------------------
63
64 Drupal contains an extensive API that allows you to add to and modify the
65 functionality of your site. The API consists of "hooks", which allow modules to
66 react to system events and customize Drupal's behavior, and functions that
67 standardize common operations such as database queries and form generation. The
68 flexible hook architecture means that you should never need to directly modify
69 the files that come with Drupal core to achieve the functionality you want;
70 instead, functionality modifications take the form of modules.
71
72 When you need new functionality for your Drupal site, search for existing
73 contributed modules. If you find a module that matches except for a bug or an
74 additional needed feature, change the module and contribute your improvements
75 back to the project in the form of a "patch". Create new custom modules only
76 when nothing existing comes close to what you need.
77
78 More about developing:
79  * Search for existing contributed modules:
80    http://drupal.org/project/modules
81  * Contribute a patch:
82    http://drupal.org/patch/submit
83  * Develop your own module:
84    http://drupal.org/developing/modules
85  * Follow best practices:
86    http://drupal.org/best-practices
87  * Refer to the API documentation:
88    http://api.drupal.org/api/drupal/7