Logo AND Algorithmique Numérique Distribuée

Public GIT Repository
improve a tiny bit the doc introduction
[simgrid.git] / doc / doxygen / getting_started.doc
index 1426d49..9bcb861 100644 (file)
@@ -6,31 +6,31 @@ SimGrid is a framework to simulate distributed computer systems.
 
 It can be used to either assess abstract algorithms, or to profile and
 debug real distributed applications.  SimGrid enables studies in the
-domains of (data-)Grids, Clusters, IaaS Clouds, High Performance
-Computing, Volunteer Computing and Peer-to-Peer.
+domains of (data-)Grids, IaaS Clouds, Clusters, High Performance
+Computing, Volunteer Computing and Peer-to-Peer systems.
 
-Technically speaking, SimGrid is a library. It is not a graphical 
-interface nor a command-line simulator running user scripts. You
-interact with SimGrid by writting programs with the exposed functions
-to build your own simulator.
+Technically speaking, SimGrid is a library. It is neither a graphical
+interface nor a command-line simulator running user scripts. The
+interaction with SimGrid is done by writing programs with the exposed
+functions to build your own simulator.
 
-SimGrid have many features, many options and many possibilities. The
+SimGrid offers many features, many options and many possibilities. The
 documentation aims at smoothing the learning curve. But nothing's
 perfect, and this documentation is really no exception here. Please
-help us improving it by reporting the issues that you see and
+help us improving it by reporting any issue that you see and
 proposing the content that is still missing.
 
-SimGrid is a Free Software distributed under the LGPL licence. It
-means that you are welcome to use it as you wish, or even to modify
-and distribute your version (as long as your version is as free as
-ours). It also means that SimGrid is developed by a vivid community of
-users and developers. We hope that you will come and join us!
+SimGrid is a Free Software distributed under the LGPL licence. You are
+thus welcome to use it as you wish, or even to modify and distribute
+your version (as long as your version is as free as ours). It also
+means that SimGrid is developed by a vivid community of users and
+developers. We hope that you will come and join us!
 
 SimGrid is the result of over 15 years of research from several
-groups, both in France and in the USA. It benefited of many fundings
+groups, both in France and in the USA. It benefited of many funding
 from various research instances, including the ANR, Inria, CNRS,
 University of Lorraine, University of Hawai'i at Manoa, ENS Rennes and
-many others. Many thanks to our generous donators!
+many others. Many thanks to our generous sponsors!
 
 @section starting_components Typical Study based on SimGrid
 
@@ -38,7 +38,8 @@ Any SimGrid study entails the following components:
 
  - The studied **Application**. This can be either a distributed
    algorithm described in our simple APIs, or a full featured real
-   parallel application using the MPI interface (or other).
+   parallel application using for example the MPI interface 
+   @ref application "(more info)".
 
  - The **Virtual Platform**. This is a description of a given
    distributed system (machines, links, disks, clusters, etc). Most of
@@ -47,19 +48,21 @@ Any SimGrid study entails the following components:
    Platform with a Dynamic Scenario where for example the links are
    slowed down (because of external usage), the machines fail. You
    have even support to specify the applicative workload that you want
-   to feed to your application.
+   to feed to your application  @ref platform "(more info)".
 
  - The application's **Deployment Description**. In SimGrid terminology,
    the application is an inert set of source files and binaries. To
    make it run, you have to describe how your application should be
-   deployed on the virtual platform. Specify which process is located
-   on which host, along with its parameters.
+   deployed on the virtual platform. Specify which process is mapped
+   on which host, along with its parameters
+   @ref deployment "(more info)".
 
  - The **Platform Models**. They describe how the virtual platform
    reacts to the actions of the application. For example, they compute
    the time taken by a given communication on the virtual platform.
    These models are already included in SimGrid, and you only need to
-   pick one and maybe tweak its configuration to get your results.
+   pick one and maybe tweak its configuration to get your results
+   @ref models "(more info)".
 
 These components are put together to run a **simulation**, that is an
 experiment or a probe. The result of one or many simulation provides