From commits-return-29373-archive-asf-public=cust-asf.ponee.io@flink.apache.org Thu Mar 26 14:21:18 2020 Return-Path: X-Original-To: archive-asf-public@cust-asf.ponee.io Delivered-To: archive-asf-public@cust-asf.ponee.io Received: from mail.apache.org (hermes.apache.org [207.244.88.153]) by mx-eu-01.ponee.io (Postfix) with SMTP id 34C7118065D for ; Thu, 26 Mar 2020 15:21:18 +0100 (CET) Received: (qmail 84888 invoked by uid 500); 26 Mar 2020 14:21:14 -0000 Mailing-List: contact commits-help@flink.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@flink.apache.org Delivered-To: mailing list commits@flink.apache.org Received: (qmail 84493 invoked by uid 99); 26 Mar 2020 14:21:14 -0000 Received: from ec2-52-202-80-70.compute-1.amazonaws.com (HELO gitbox.apache.org) (52.202.80.70) by apache.org (qpsmtpd/0.29) with ESMTP; Thu, 26 Mar 2020 14:21:14 +0000 Received: by gitbox.apache.org (ASF Mail Server at gitbox.apache.org, from userid 33) id 6591F81A31; Thu, 26 Mar 2020 14:21:13 +0000 (UTC) Date: Thu, 26 Mar 2020 14:21:23 +0000 To: "commits@flink.apache.org" Subject: [flink-statefun] 11/14: [FLINK-16758][docs] Update branding MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit From: tzulitai@apache.org In-Reply-To: <158523247279.16808.7426497555408258056@gitbox.apache.org> References: <158523247279.16808.7426497555408258056@gitbox.apache.org> X-Git-Host: gitbox.apache.org X-Git-Repo: flink-statefun X-Git-Refname: refs/heads/release-2.0 X-Git-Reftype: branch X-Git-Rev: ff041c42013f6f7a9665cd20d66172f2c732afd1 X-Git-NotificationType: diff X-Git-Multimail-Version: 1.5.dev Auto-Submitted: auto-generated Message-Id: <20200326142113.6591F81A31@gitbox.apache.org> This is an automated email from the ASF dual-hosted git repository. tzulitai pushed a commit to branch release-2.0 in repository https://gitbox.apache.org/repos/asf/flink-statefun.git commit ff041c42013f6f7a9665cd20d66172f2c732afd1 Author: Seth Wiesman AuthorDate: Wed Mar 25 08:54:11 2020 -0500 [FLINK-16758][docs] Update branding This closes #73. --- docs/README.md | 4 +- docs/_config.yml | 4 +- docs/_includes/sidenav.html | 2 +- docs/_layouts/base.html | 10 +- docs/getting-started/walkthrough.md | 2 +- docs/index.md | 4 +- docs/io-module/flink-connectors.md | 4 +- docs/page/favicon.ico | Bin 1150 -> 0 bytes docs/page/favicon.png | Bin 0 -> 61427 bytes docs/page/img/navbar-brand-logo.jpg | Bin 18470 -> 0 bytes docs/page/img/navbar-brand-logo.png | Bin 0 -> 57778 bytes statefun-docs/docs/conf.py | 231 ------------------------------------ statefun-docs/pom.xml | 148 ----------------------- 13 files changed, 14 insertions(+), 395 deletions(-) diff --git a/docs/README.md b/docs/README.md index c3d5f63..78c8a47 100644 --- a/docs/README.md +++ b/docs/README.md @@ -1,6 +1,6 @@ -This README gives an overview of how to build and contribute to the documentation of Apache Flink. +This README gives an overview of how to build and contribute to the documentation of Apache Flink Stateful Functions. -The documentation is included with the source of Apache Flink in order to ensure that you always +The documentation is included with the source of Apache Flink Stateful Functions in order to ensure that you always have docs corresponding to your checked out version. The online documentation at https://flink.apache.org/ is also generated from the files found here. diff --git a/docs/_config.yml b/docs/_config.yml index bc4177f..a92921a 100644 --- a/docs/_config.yml +++ b/docs/_config.yml @@ -27,10 +27,10 @@ # we change the version for the complete docs when forking of a release branch # etc. # The full version string as referenced in Maven (e.g. 1.2.1) -version: "2.0-SNAPSHOT" +version: "2.1-SNAPSHOT" # For stable releases, leave the bugfix version out (e.g. 1.2). For snapshot # release this should be the same as the regular version -version_title: "2.0-SNAPSHOT" +version_title: "2.1-SNAPSHOT" # Branch on Github for this version github_branch: "master" diff --git a/docs/_includes/sidenav.html b/docs/_includes/sidenav.html index 4697a9f..4c10ebd 100644 --- a/docs/_includes/sidenav.html +++ b/docs/_includes/sidenav.html @@ -80,7 +80,7 @@ level is determined by 'nav-pos'. {%- assign pos = 0 -%}
    {%- for i in (1..10000) -%} diff --git a/docs/_layouts/base.html b/docs/_layouts/base.html index 512838a..9ba8cf8 100644 --- a/docs/_layouts/base.html +++ b/docs/_layouts/base.html @@ -23,9 +23,9 @@ under the License. - Apache Flink {{ site.version_title }} Documentation: {{ page.title }} - - + Apache Flink Stateful Functions {{ site.version_title }} Documentation: {{ page.title }} + + @@ -58,9 +58,9 @@ under the License. {% if site.show_outdated_warning %}
    {% if page.language == "en" %} - This documentation is for an out-of-date version of Apache Flink. We recommend you use the latest stable version. + This documentation is for an out-of-date version of Apache Flink Stateful Functions. We recommend you use the latest stable version. {% else if page.language == "zh" %} - 本文档是 Apache Flink 的旧版本。建议访问 最新的稳定版本。 + 本文档是 Apache Flink Stateful Functions 的旧版本。建议访问 最新的稳定版本。 {% endif %}
    {% endif %} diff --git a/docs/getting-started/walkthrough.md b/docs/getting-started/walkthrough.md index 4c895bd..b55b0a4 100644 --- a/docs/getting-started/walkthrough.md +++ b/docs/getting-started/walkthrough.md @@ -169,7 +169,7 @@ public final class GreetFunction implements StatefulFunction { Each time a message is processed, the function computes a personalized message for that user. It reads and updates the number of times that user has been seen and sends a greeting to the egress. -You can check the full code for the application described in this walkthrough `here <{examples}/statefun-greeter-example>`. +You can check the full code for the application described in this walkthrough [here]({{ site.github_url }}/tree/{{ site.github_branch }}/statefun-examples/statefun-greeter-example). In particular, take a look at the module ``GreetingModule``, which is the main entry point for the full application, to see how everything gets tied together. You can run this example locally using the provided Docker setup. diff --git a/docs/index.md b/docs/index.md index 3d04c4f..4d25af3 100644 --- a/docs/index.md +++ b/docs/index.md @@ -1,5 +1,5 @@ --- -title: "Stateful Functions - An Apache Flink® Project" +title: "Stateful Functions Documentation" nav-pos: 0 nav-title: ' Home' nav-parent_id: root @@ -23,8 +23,6 @@ specific language governing permissions and limitations under the License. --> -## A Framework for Stateful Distributed Applications - **Stateful Functions** is an open source framework that reduces the complexity of building and orchestrating distributed stateful applications at scale. It brings together the benefits of stream processing with Apache Flink® and Function-as-a-Service (FaaS) to provide a powerful abstraction for the next generation of event-driven architectures. diff --git a/docs/io-module/flink-connectors.md b/docs/io-module/flink-connectors.md index d25e539..dac8c2a 100644 --- a/docs/io-module/flink-connectors.md +++ b/docs/io-module/flink-connectors.md @@ -33,7 +33,7 @@ For details details of how to build a custom connector see the official [Apache ## Dependency -To use the Kafka I/O Module in Java, please include the following dependency in your pom. +To use a custom Flink connector, please include the following dependency in your pom. {% highlight xml %} @@ -92,4 +92,4 @@ public class ModuleWithSinkSpec implements StatefulFunctionModule { binder.bindEgress(spec); } } -{% endhighlight %} \ No newline at end of file +{% endhighlight %} diff --git a/docs/page/favicon.ico b/docs/page/favicon.ico deleted file mode 100644 index 34a467a..0000000 Binary files a/docs/page/favicon.ico and /dev/null differ diff --git a/docs/page/favicon.png b/docs/page/favicon.png new file mode 100644 index 0000000..000a103 Binary files /dev/null and b/docs/page/favicon.png differ diff --git a/docs/page/img/navbar-brand-logo.jpg b/docs/page/img/navbar-brand-logo.jpg deleted file mode 100644 index 5993ee8..0000000 Binary files a/docs/page/img/navbar-brand-logo.jpg and /dev/null differ diff --git a/docs/page/img/navbar-brand-logo.png b/docs/page/img/navbar-brand-logo.png new file mode 100644 index 0000000..677c4d7 Binary files /dev/null and b/docs/page/img/navbar-brand-logo.png differ diff --git a/statefun-docs/docs/conf.py b/statefun-docs/docs/conf.py deleted file mode 100644 index adc6b71..0000000 --- a/statefun-docs/docs/conf.py +++ /dev/null @@ -1,231 +0,0 @@ - -# 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. - -# If extensions (or modules to document with autodoc) are in another directory, -# add these directories to sys.path here. If the directory is relative to the -# documentation root, use os.path.abspath to make it absolute, like shown here. -# -# import os -# import sys -# sys.path.insert(0, os.path.abspath('.')) -import re - - -# -- General configuration ------------------------------------------------ - -# If your documentation needs a minimal Sphinx version, state it here. -# -# needs_sphinx = '1.0' - -# Add any Sphinx extension module names here, as strings. They can be -# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom -# ones. -# https://github.com/djungelorm/sphinx-tabs -extensions = ['sphinx.ext.ifconfig', 'sphinx_tabs.tabs'] - -# Add any paths that contain templates here, relative to this directory. -templates_path = ['_templates'] - -# The suffix(es) of source filenames. -# You can specify multiple suffix as a list of string: -# -# source_suffix = ['.rst', '.md'] -source_suffix = '.rst' - -# The master toctree document. -master_doc = 'index' - -# Warn about broken references -nitpicky = True - -# General information about the project. -project = u'Stateful Functions' -copyright = u'2019, The Apache Software Foundation.' -author = u'The Apache Flink authors.' - -# Render it manually in the footer.html -html_show_copyright = False - -# The version info for the project you're documenting, acts as replacement for -# |version| and |release|, also used in various other places throughout the -# built documents. -# -# The short X.Y version. -version = u'2.0-SNAPSHOT' -# The full version, including alpha/beta/rc tags. -release = u'2.0.0' -# The latest Flink version supported by Stateful Functions -flinkVersion = u'1.10' -# The latest full Flink version supported by Stateful Functions -flinkRelease = u'1.10.0' -# The source code repository -repo = "https://github.com/apache/flink-statefun" - -# The examples directory -example_source = repo + "/tree/master/statefun-examples" - -# hide source link -html_show_sourcelink = False -# required for the search to work -html_copy_source = True - -# The language for content autogenerated by Sphinx. Refer to documentation -# for a list of supported languages. -# -# This is also used if you do content translation via gettext catalogs. -# Usually you set "language" from the command line for these cases. -language = None - -# List of patterns, relative to source directory, that match files and -# directories to ignore when looking for source files. -# This patterns also effect to html_static_path and html_extra_path -exclude_patterns = ['_build', 'Thumbs.db', '.DS_Store', "hidden"] - -# The name of the Pygments (syntax highlighting) style to use. -pygments_style = 'default' - -# If true, `todo` and `todoList` produce output, else they produce nothing. -todo_include_todos = False - - -# -- Options for HTML output ---------------------------------------------- - -# The theme to use for HTML and HTML Help pages. See the documentation for -# a list of builtin themes. -# -html_theme = 'sphinx_rtd_theme' - -# Theme options are theme-specific and customize the look and feel of a theme -# further. For a list of options available for each theme, see the -# documentation. -# -html_theme_options = { - 'titles_only': True, - 'canonical_url': 'https://statefun.io/', - 'display_version': False, - #'prev_next_buttons_location': None -} - -html_show_sphinx = False - - -# Add any paths that contain custom static files (such as style sheets) here, -# relative to this directory. They are copied after the builtin static files, -# so a file named "default.css" will overwrite the builtin "default.css". -html_static_path = ['_static'] - -# Custom sidebar templates, must be a dictionary that maps document names -# to template names. -# -# This is required for the alabaster theme -# refs: http://alabaster.readthedocs.io/en/latest/installation.html#sidebars -html_sidebars = { - '**': [ - 'relations.html', # needs 'show_related': True theme option to display - 'searchbox.html', - ] -} - -# -- Options for HTMLHelp output ------------------------------------------ - -# Output file base name for HTML help builder. -htmlhelp_basename = 'StatefulFunctionsdoc' - -# -- Options for LaTeX output --------------------------------------------- - -latex_elements = { - # The paper size ('letterpaper' or 'a4paper'). - # - # 'papersize': 'letterpaper', - - # The font size ('10pt', '11pt' or '12pt'). - # - # 'pointsize': '10pt', - - # Additional stuff for the LaTeX preamble. - # - # 'preamble': '', - - # Latex figure (float) alignment - # - # 'figure_align': 'htbp', -} - -# Grouping the document tree into LaTeX files. List of tuples -# (source start file, target name, title, -# author, documentclass [howto, manual, or own class]). -latex_documents = [ - (master_doc, 'StatefulFunctions.tex', u'Stateful Functions Documentation', - u'Apache Flink', 'manual'), -] - - -# -- Options for manual page output --------------------------------------- - -# One entry per manual page. List of tuples -# (source start file, name, description, authors, manual section). -man_pages = [ - (master_doc, 'stateful-functions', u'Stateful Functions Documentation', - [author], 1) -] - - -# -- Options for Texinfo output ------------------------------------------- - -# Grouping the document tree into Texinfo files. List of tuples -# (source start file, target name, title, author, -# dir menu entry, description, category) -texinfo_documents = [ - (master_doc, 'Stateful Functions', u'Stateful Functions Documentation', - author, 'Stateful Functions', 'One line description of project.', - 'Miscellaneous'), -] - -# -- Settings for sphinxcontrib-versioning -------------------------------- -scv_greatest_tag = True -scv_show_banner = True -scv_banner_greatest_tag = True -scv_sort = ('semver', 'alpha') -scv_whitelist_branches = (re.compile(r'^v\d+\.\d+$'), - re.compile(r'^v\d+\.\d+\.\d+$'), - 'latest') -scv_whitelist_tags = (re.compile(r'^v\d+\.\d+$'), - re.compile(r'^v\d+\.\d+\.\d+$'), - 'latest') - -## Sphynx macros do not work inside of -## code blocks, so we include these custom -## replacements to autofill in versions in -## all places. -def customReplace(app, docname, source): - result = source[0] - for key in app.config.custom_replacements: - result = result.replace(key, app.config.custom_replacements[key]) - source[0] = result - -custom_replacements = { - "{release}" : release, - "{version}" : version, - "{flink}" : u'Apache Flink®', - "{flinkVersion}" : flinkVersion, - "{flinkRelease}" : flinkRelease, - "{repo}" : repo, - "{examples}" : example_source -} - -def setup(app): - app.add_config_value('custom_replacements', {}, True) - app.connect('source-read', customReplace) diff --git a/statefun-docs/pom.xml b/statefun-docs/pom.xml deleted file mode 100644 index d97bc05..0000000 --- a/statefun-docs/pom.xml +++ /dev/null @@ -1,148 +0,0 @@ - - - - - 4.0.0 - - - statefun-parent - org.apache.flink - 2.0-SNAPSHOT - - - statefun-docs - statefun-docs - pom - - - - org.apache.flink - statefun-sdk - ${project.version} - provided - - - org.apache.flink - statefun-flink-io - ${project.version} - provided - - - org.apache.flink - statefun-kafka-io - ${project.version} - provided - - - org.apache.flink - statefun-kinesis-io - ${project.version} - - - com.fasterxml.jackson.core - jackson-databind - 2.9.6 - provided - - - junit - junit - 4.12 - provided - - - - - - - org.apache.maven.plugins - maven-surefire-plugin - 2.12.4 - - true - - - - org.apache.maven.plugins - maven-jar-plugin - 2.6 - - - default-jar - none - - - - - org.apache.maven.plugins - maven-install-plugin - 2.5.2 - - - default-install - none - - - - - org.apache.maven.plugins - maven-deploy-plugin - 2.8.2 - - - default-deploy - none - - - - - org.apache.rat - apache-rat-plugin - 0.13 - - - verify - - check - - - - - - - **/.*/** - **/*.prefs - **/*.log - - **/README.md - .github/** - - **/target/** - **/_build/** - requirements.txt - runtime.txt - /docs/_templates/** - - **/generated/** - - - - - - \ No newline at end of file