commit e089652c0dc81732a16e84762bf733ad60fa02eb Author: Toshaan Bharvani Date: Thu Jun 17 21:13:31 2021 +0200 intial hub charter, as of my notes Signed-off-by: Toshaan Bharvani diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..067cf4d --- /dev/null +++ b/.gitignore @@ -0,0 +1,3 @@ +#!.gitignore +*.pdf +version diff --git a/Makefile b/Makefile new file mode 100755 index 0000000..de23d2f --- /dev/null +++ b/Makefile @@ -0,0 +1,33 @@ +#!Makefile + +default all: pdf + +TEXFILE=charter + +TMPDIR:=$(shell mktemp -d /tmp/latex.XXXX) +FIRSTTAG:=$(shell git describe --abbrev=0 --tags --always) +RELTAG:=$(shell git describe --tags --long --always --dirty='-*' --match '[0-9]*.*') + +pdf: gitinfo tex + +.PHONY: gitinfo +gitinfo: + @git --no-pager log -1 --date=short --decorate=short --pretty=format:"\usepackage[shash={%h},lhash={%H},authname={%an},authemail={%ae},authsdate={%ad},authidate={%ai},authudate={%at},commname={%an},commemail={%ae},commsdate={%ad},commidate={%ai},commudate={%at},refnames={%d},firsttagdescribe="${FIRSTTAG}",reltag="${RELTAG}"]{gitexinfo}" HEAD > $(TMPDIR)/gitHeadLocal.gin + +tex: $(TEXFILE).tex + @test -d $(TMPDIR) || mkdir $(TMPDIR) + @echo "Running 2 compiles $(TMPDIR)" + @pdflatex -output-directory=$(TMPDIR) -interaction=batchmode -file-line-error -no-shell-escape $< > /dev/null + @makeglossaries -d $(TMPDIR) $(TEXFILE) + @pdflatex -output-directory=$(TMPDIR) -interaction=batchmode -file-line-error -no-shell-escape $< > /dev/null + @cp $(TMPDIR)/$(TEXFILE).pdf . + @echo $(FIRSTTAG) > version + @echo "$(TEXFILE) PDF Ready" + +.PHONY: clean +clean: + @rm -rf /tmp/latex.* + +cleanall: + @rm -rf /tmp/latex.* + @rm -f $(TEXFILE).pdf diff --git a/appendices.tex b/appendices.tex new file mode 100644 index 0000000..e69de29 diff --git a/charter.tex b/charter.tex new file mode 100755 index 0000000..7c2a172 --- /dev/null +++ b/charter.tex @@ -0,0 +1,125 @@ +\documentclass[a4paper,12pt]{report} + +% packeges +\usepackage[a4paper]{geometry} +\usepackage{fancyhdr} +\usepackage{lastpage} +%\usepackage{amsmath} +%\usepackage{amssymb} +%\usepackage{amsthm} +%\usepackage{array} +%\usepackage{xy} +\usepackage{longtable} +\usepackage{multirow} +\usepackage{setspace} +\usepackage{graphicx} +\usepackage{url} +\usepackage{hyperref} +\usepackage{color} +\usepackage{etex} +\usepackage[local]{gitinfo2} +\usepackage{titlesec} +%\usepackage{draftwatermark} +\usepackage[acronym,ucmark,nomain]{glossaries} +%\usepackage[curly,sort,comma,numbers]{natbib} + +%compression +\pdfminorversion=7 +\pdfcompresslevel=9 +\pdfobjcompresslevel=2 + +\hypersetup{ + %hyperindex=true, + %hyperfigures=true, + %pagebackref=true, + %backref, + colorlinks=true, + linkcolor=black, + anchorcolor=black, + citecolor=black, + filecolor=black, + menucolor=black, + pagecolor=black, + urlcolor=black, + %bookmarksnumbered, + %pdfborder=0 0 0,' + pdftoolbar=false, + pdfmenubar=false, + %bookmarks=false, + pdfproducer={OPF Template Generator}, + pdfcreator={OPF POWER ISA TWG}, + pdfauthor={Toshaan Bharvani }, + pdftitle={OpenPOWER Foundation ISA TWG Charter}, + pdfsubject={OpenPOWER Foundation ISA TWG Charter}, + pdfkeywords={OPF,OpenPOWER,POWER ISA,ISA,charter} +} + +% page layout +\geometry{top=30mm} +\geometry{bottom=20mm} +\geometry{left=20mm} +\geometry{right=20mm} +\geometry{headheight=25mm} +\geometry{headsep=10mm} +\geometry{foot=10mm} + +%\renewcommand{\partname}{} +%\renewcommand{\thechapter}{\arabic{chapter}} +%\renewcommand{\thepart}{\arabic{part}.} +\renewcommand{\thesection}{\arabic{section}.} +\renewcommand{\thesubsection}{\thesection\arabic{subsection}.} +\renewcommand{\thesubsubsection}{\thesection\thesubsection\arabic{subsubsection}} + +%\SetWatermarkText{Draft} +%\SetWatermarkScale{10} + +\input{glossaries.tex} + +% real begining +\begin{document} + +\pagenumbering{arabic} +\setcounter{page}{1} + +%\renewcommand{\baselinestretch}{2} +%\doublespacing +\setlength{\parindent}{0em} +\setlength{\parskip}{0em} + +\pagestyle{fancy} +\renewcommand{\headrulewidth}{2pt} +\renewcommand{\footrulewidth}{2pt} + +% fancyhdr +\fancyhead{} +\fancyhead[L]{ + \includegraphics[width=4cm]{opf-logo.png} +} +\fancyhead[R]{ + OpenPOWER Foundation Workgroup Charter +} + +\fancyfoot{} +\fancyfoot[L]{ + \begin{tiny} + OPF Workgroup Charter + \end{tiny} +} +\fancyfoot[C]{ + \begin{tiny} + \gitFirstTagDescribe{} (\gitAbbrevHash{} - \gitAuthorDate{}) + \end{tiny} +} +\fancyfoot[R]{ + \begin{tiny} + \thepage\ of \pageref{LastPage} + \end{tiny} +} + +%%% +\input{content.tex} +\input{appendices.tex} + +\printglossary[type=\acronymtype,title=List of Acronyms] + +\end{document} diff --git a/content.tex b/content.tex new file mode 100644 index 0000000..e6dce0b --- /dev/null +++ b/content.tex @@ -0,0 +1,232 @@ +%%% + +\section{Workgroup name} + +HUB \acrfull{STIG} + +\section{Definitions} + +Reference the OpenPOWER Foundation \acrshort{IPR} Policy and OpenPOWER WorkGroup Process for additional term definitions. + +\begin{enumerate} +\item +``Provider" is an Eligible participant of the workgroup that has been elected by Full Majority Vote to provide OpenPOWER resources +to the Open Source community for the purpose of enabling, promoting, converting, porting, and testing open source on OpenPOWER. +\item +``" +\end{enumerate} + +\section{Description} + +The HUB \acrshort{STIG} is a workgroup whose purpose is to enable the process of porting to OpenPOWER, +this \acrshort{STIG} will enable the porting, conversion, and testing of open source on OpenPOWER. +This \acrshort{STIG} will provide resources for these efforts by levering Providers to enable open source to gain access to +OpenPOWER resources for the purpose of porting, converting, and maintaining open source resources to be enabled on OpenPOWER.\par + +The HUB \acrshort{STIG} will create processes, documentation, code and how-to guides to assist in OpenPOWER enablement. +In addition to these documents, the HUB \acrshort{STIG} will provide resources that enable the porting, conversion and maintance +throught Providers that have resources available to assist open source in this effort.\par + +The purpose of the HUB is to be a central place where a public open source project can reach out to for help. +It is up to the HUB to assist these projects in their endavour to OpenPOWER.\par + +\section{Scope} + +The scope of the HUB \acrshort{STIG} is the creation of a central place for OpenPOWER porting. +The \acrshort{STIG} will do this by providing documentation, code, and resources to enable the porting, converting, and maintaining +of open source on OpenPOWER.\par + +The HUB \acrshort{STIG} will create documentation on how to enable open source on OpenPOWER. +It will do this in a way to enable all features, and options available on OpenPOWER. +This documentataion will be made publically available and be distributed within several open source communities.\par + +In addition to the documentation, the HUB \acrshort{STIG} will work with Providers to make resources, such as but not limited to +\begin{itemize} +\item +Cloud Server Hardware +\item +FPGA based Hardware +\item +GPU based Hardware +\item +Specialized hardware +\item +Software distributions +\end{itemize} +\par + +In addition the HUB \acrshort{STIG} will be a workgroup that evangalises the adoption of OpenPOWER +through technical documentation and resource availability.\par + +\section{Similar Activities} + +\begin{itemize} +\item +Accelerator Workgroup : may work with to define the requirements for open tooling needed to complete the implementation of OpenPOWER +\item +Memory Workgroup : defines the requirements for OpenPOWER Memory adoption, such as OMI +\item +HW Architecture Workgroup : maintains the hardware architecture specifications that may be needed for new development +\item +System Software Workgroup : owns definition, documentation, and maintenance of the firmware, Linux and other software on OpenPOWER +\item +Development Platform Workgroup : defines the reference architecture of future OpenPower systems +\end{itemize} + +\section{Users} + +Any open source project that plans to run on OpenPOWER. + +\section{Work Product} + +\begin{itemize} +\item +Documentation for adoption of, porting to, converting to OpenPOWER +\item +Code, such as patches for OpenPOWER, to be pushed to the upstream project +\item +Ensure maintaining open source enablement of OpenPOWER +\end{itemize} + +\section{Projects} + +\begin{itemize} +\item +Build documentation on adoption of, porting to, converting to OpenPOWER +\item +Assist in code patching of open source to OpenPOWER +\item +Assist in maintenance of open source on OpenPOWER +\item +Provide resources for open source to OpenPOWER +\end{itemize} + +\section{Participation} + +Public\par + +Participation and voting right requirements are as outlined per the OpenPOWER Work Group Process.\par + +A minimum of two Eligeble Participant will be required to be a Providers. +Providerss will have the responsibility to make resources available for open source to consume for the purpose of +porting, adopting, maintaining, or enhancing OpenPOWER.\par + +\section{Work Group Convener} + +Lance Albertson (OSU) - Toshaan Bharvani (VanTosh) + +\section{Meeting Plan} + +Lance will convene the first meeting.\par + +The first meeting will be at 18:00 CET on the second Thursday after the TSC and BoD approve the formation of the SIG. +Subsequent meetings will be held bi-weekly alternating between 18:00 CET Thursday and 00:00 CET Tuesday to accommodate participants in all time zones. + +\section{Participants} + +\begin{itemize} +\item +Oregon State University + \begin{itemize} + \item + Lance Albertson () + \end{itemize} +\item +Raptor Computing Systems + \begin{itemize} + \item + Timothy Pearson (tpearson@raptorengineering.com) + \end{itemize} +\item +VanTosh + \begin{itemize} + \item + Toshaan Bharvani (toshaan@vantosh.com) + \end{itemize} +\item +IBM + \begin{itemize} + \item + Paul Lecocq (lecocq@us.ibm.com) + \end{itemize} +\item +Yadro + \begin{itemize} + \item + Alexey Stepanov (a.stepanov@yadro.com) + \end{itemize} +\end{itemize} + +\section{Balloting Approval Requirements} + +Standard WG Process applies with the following specific requirements with respect to Providers : +\begin{itemize} +\item +Election of Providers will be by Full Majority Vote. +A Provider can be removed from their position as Provider by Full Majority Vote as well. +\item +The initial Providers will be voted in the first meeting. +\end{itemize} + +\section{Member Organization Support} + +Member organization support will be confirmed as part of the approval process. + +\section{Anticipated Contributions} + +none + +\section{IPR, Confidentiality \& Licensing} + +The following sections may not be modified after chartering. Changes require closing and submitting a new charter. + +\subsection{Confidentiality Mode} + +Non-confidential + +\subsection{IPR Policy} + +Code Mode + +\subsection{Open Source Licensing Mode} + +Apache License, v2.0\par + +All Code contributed to the WG by a WG Member or WG Party shall be licensed to OpenPOWER under Apache License, V2.0 +with the condition that the patent license granted in Section 3 of the License, as applied to the ``Work", hereby +includes implementations of the Work in physical form.\par + +Code contributed to the WG by a WG member or WG party may be licensed to OpenPOWER under a future open hardware license with +WG, TSC, and Board approval.\par + +All contributions to the WG's git repository must include a developer certificate of originality. +Non-Eligible person contributions to the git repository are bound to a Guest Participation Agreement. +The Guest Participation Agreement for this WG is agreement to the terms of the OS license as defined in the OS Licensing Mode and +documented in the license file within the WG's git repository.\par + +The Guest Participation Agreement is agreed to automatically upon any contribution to the WG's git repository. +Any contributions made outside the WG's git repository by a non-Eligible person must include a signed +Contribution / Feedback License as defined in Section 7.1 and Appendix A of the OpenPOWER IPR Policy. +Alternatively this WG can provide a Guest Participation Agreement to be signed per Section 7.2.\par + +The executed Contribution / Feedback License or Guest Participation Agreement must be sent to hub@openpower.foundation.\par + +As a default position, all Code that is, or is made part of, an OpenPOWER Deliverable shall be licensed out by OpenPOWER under one of the following +licenses and shall at least be provided in source code form. +The selected license will include or be accompanied by a clarification that any necessary license rights for the POWER \acrshort{ISA} comes from +the POWER \acrshort{ISA} license and is not granted under the selected license for the OpenPOWER Deliverable. +\begin{itemize} +\item +Apache License, V2.0 with the condition that the patent license granted in Section 3 of the License, as applied to the ``Work", +hereby includes implementations of the Work in physical form. +\item +a future open hardware license with WG, TSC, and Board approval. +\end{itemize} + +\subsection{Open Source Communities} + +This WG may accept Code from the following OS Communities under their respective licenses. + +This WG may accept or contribute Code from/to additional OS Communities with approval by the WG, TSC, and Board. +Any code accepted from or contributed to approved OS Communities must be under a Permissive License such as +Apache License, v2.0, 2 or 3 clause BSD, MIT, ISC, or other OS license approved by the WG, TSC, and Board. diff --git a/glossaries.tex b/glossaries.tex new file mode 100644 index 0000000..83621a8 --- /dev/null +++ b/glossaries.tex @@ -0,0 +1,11 @@ +\makeglossaries + +\renewcommand*{\glspostdescription}{} + +%%% Common Acronyms +\newacronym{IPR}{IPR}{Intellectual Property Rights} +\newacronym{SIG}{SIG}{Special Integration Work Group} +\newacronym{TWG}{TWG}{Technical Work Group} +\newacronym{STIG}{STIG}{Special Technical Integration Group} + +%%% Specific Acronyms diff --git a/opf-logo.png b/opf-logo.png new file mode 100644 index 0000000..4f80d8f Binary files /dev/null and b/opf-logo.png differ