/*
 * Licensed to the Apache Software Foundation (ASF) under one or more
 * contributor license agreements.  See the NOTICE file distributed with
 * this work for additional information regarding copyright ownership.
 * The ASF licenses this file to You under the Apache License, Version 2.0
 * (the "License"); you may not use this file except in compliance with
 * the License.  You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

/**
 * Takes the source HTML files in the {@code sis-site/main/source/developer-guide/} directory
 * and assembles them in a single file to be published in the {@code asf-staging/book/} directory.
 *
 * <p>The main class in this package is {@link org.apache.sis.internal.book.Assembler}.
 * Other classes are helper classes that should be ignored. Assuming the following directory layout:</p>
 *
 * <pre>&lt;current directory&gt;
 * ├─ master
 * │   └─ core
 * │       └─ sis-build-helper
 * └─ site
 *     ├─ source
 *     └─ static
 * </pre>
 *
 * Then the command can be used as below on Unix systems:
 *
 * <pre>java -classpath master/core/sis-build-helper/target/classes org.apache.sis.internal.book.Assembler site</pre>
 *
 * @author  Martin Desruisseaux (Geomatys)
 * @version 1.2
 * @since   0.7
 */
package org.apache.sis.internal.book;

@@ -1525,16 +1525,497 @@
 pre%3E%0A *%0A
+ * %3Ch2%3EFuture evolution%3C/h2%3E%0A * We may replace (at least partially) this tools by some more advanced open-source alternatives.%0A * Known candidates are:%0A *%0A * %3Cul%3E%0A *   %3Cli%3E%3Ca href=%22http://www.xmlmind.com/ebookc/%22%3EXMLmind Ebook Compiler%3C/a%3E%3C/li%3E%0A * %3C/ul%3E%0A *%0A * A goal is to keep HTML5 as the language of source files, not DocBook or AsciiDoc or others.%0A * See %3Ca href=%22http://www.xmlmind.com/tutorials/HTML5Books/HTML5Books.html%22%3EHTML5 as an alternative to DITA and DocBook%3C/a%3E.%0A *%0A
  * @auth

Add a note about possible replacement for our custom tools assembling the developer-guide.