From 6113f55101145d84bd4c48d4557503d6531cc351 Mon Sep 17 00:00:00 2001 From: Mark Harrah Date: Wed, 27 Mar 2013 09:17:53 -0400 Subject: [PATCH] Docs: present the TaskInputs page as motivation and for deeper understanding --- src/sphinx/Detailed-Topics/TaskInputs.rst | 22 +++++++++------------- 1 file changed, 9 insertions(+), 13 deletions(-) diff --git a/src/sphinx/Detailed-Topics/TaskInputs.rst b/src/sphinx/Detailed-Topics/TaskInputs.rst index e6a223b6e..0bfacf322 100644 --- a/src/sphinx/Detailed-Topics/TaskInputs.rst +++ b/src/sphinx/Detailed-Topics/TaskInputs.rst @@ -1,22 +1,18 @@ -======================== -Task Inputs/Dependencies -======================== +========================== +Tasks/Settings: Motivation +========================== -Tasks with dependencies are now introduced in the -:doc:`getting started guide `, -which you may wish to read first. This older page may have some additional detail. +This page motivates the task and settings system. +You should already know how to use tasks and settings, which are +described in the :doc:`getting started guide ` +and on the :doc:`Tasks` page. -*Wiki Maintenance Note:* This page should have its overlap with the -getting started guide cleaned up, and just have any advanced or -additional notes. It should maybe also be consolidated with :doc:`Tasks`. - -An important aspect of the task system introduced in sbt 0.10 is to -combine two common, related steps in a build: +An important aspect of the task system is to combine two common, related steps in a build: 1. Ensure some other task is performed. 2. Use some result from that task. -Previous versions of sbt configured these steps separately using +Earlier versions of sbt configured these steps separately using 1. Dependency declarations 2. Some form of shared state