Commit ffee7f7d5e698b46ae1a72051c6285ae85a2675e
1 parent
839026e2
Exists in
master
and in
3 other branches
Review of the features section content
Showing
1 changed file
with
21 additions
and
9 deletions
Show diff stats
opensym2017/content/05-features.tex
... | ... | @@ -3,21 +3,33 @@ |
3 | 3 | |
4 | 4 | %TODO: Paulo e Melissa |
5 | 5 | |
6 | -The new generation of the SPB portal is made up of a combination of collaborative softwares features. Some of these features were expanded or limited according to government requirements. Other required features, unavailable in these softwares, were developed and sent back to their official repository as contributions. As result, we have a platform which integrate and harmonize features like social networking, mailing list, version control system, content management and source code quality monitoring. | |
6 | +The new generation of the SPB portal is made up of collaborative softwares features. Some of these features were expanded or limited according to government requirements. Other required features was totally developed by the SPB team, because it was not available in any of the integrated software. But wherever possible, the developed code was sent back to official repository of these softwares as a contribution. | |
7 | 7 | |
8 | -Our aim was to develop features reusing functions available in the collaborative softwares which integrate the platform. In addition, we treated to remaining this integration transparent to end users. | |
8 | +As result, we have a platform which integrate and harmonize features like social networking, mailing list, version control system, content management and source code quality monitoring. Our aim was to develop features reusing functions of the collaborative softwares which integrate the platform. In addition, we treated to remaining this integration transparent to end users. | |
9 | 9 | |
10 | -\subsection{Software, development tools and community} | |
11 | -In the new SPB portal, each software has a standard set of pages and tools. Besides the pages with help content and user support, a software has a section of download and version control and several mechanisms to manager the software development within the platform. These mechanisms includes git repository, wiki pages and issues tracking. | |
10 | +\subsection{Software and Software Community} | |
11 | +In the new SPB portal, each software has a standard set of pages and tools. Besides the pages with help content and user support, a software has a section of download and version control and several mechanisms to manager the software development within the platform. | |
12 | 12 | |
13 | -Focusing on the collaborative development, each software has pages and tools to support the dialog and communication between developers, users and enthusiasts. The software has its own mailing list, where its privacy can be moderated according to the maturity of the software in this aspect. It also has a related community, where you can find its members, a blog or any other relevant content made by the community and a summary of recent activities in the spaces of interaction of this software. | |
13 | +Focusing on the collaborative development, the platform provides mechanisms to support the dialog and communication between developers, users and enthusiasts of a software. The software has its own mailing list, where its privacy can be moderated according to the maturity of the software in this aspect. | |
14 | 14 | |
15 | -In order to assist decision-making, the new SPB has acquired assessment and statistical tools. Now, the users can rate the software using a score and comment, so this information is displayed to anyone. Moreover, the software dispose a statistic section containing values which are calculated through data provided by user and system. | |
15 | +The community of a software is a social space where anyone can find its members, blogs, a summary of recent activities in the spaces of interaction of this software and any other relevant content made by the community. Logged users can request a membership to the community and community members can access and edit restricted content. For this purpose, many features of Noosfero was integrated such as social network and content management. | |
16 | 16 | |
17 | -The rule of administrator exist in the software and in its community. The administrator is responsible to moderate content to be published, members and comments from user rating. He is also the person who can make changes in the software homepage content. | |
17 | +In order to assist decision-making, the new SPB has acquired assessment and statistical tools. Now, the users can rate the software using a score and comment, so this information is displayed to anyone. Moreover, the software dispose a section containing its statistical data, where the values are calculated through data provided by users and the system. | |
18 | + | |
19 | +The role of administrator is present in the software and in its community. The administrator is responsible for moderating content, memberships and user comments. He is also the one who can make changes in the software homepage content. | |
18 | 20 | |
19 | 21 | \subsection{Software Catalog and global search} |
20 | 22 | |
21 | -Some available softwares on the platform are highlighted in the portal homepage, but the best way to index all softwares are by a searching in the Software Catalog. In this catalog, some search options like filters by kind of software or categories, sorting and score were developed to improve the navigation. | |
23 | +The user can find some softwares highlighted on the portal homepage, but the best way to search for all available softwares is via the Software Catalog. In this catalog, some search options were developed to improve the navigation, such as filters by kind of software or categories, sorting and score. | |
24 | + | |
25 | +Expanding the scope of search to cover other kinds of content, the SPB team developed the global search tool. This tool integrates the search mechanisms provided by the collaborative softwares that make up the platform. Any user can find a public content in the context of social network, mailing list and software development. | |
26 | + | |
27 | +\subsection{Software development tools} | |
28 | + | |
29 | +In addition to interests of users and government agents, the new SPB provides tools to encourage developers of each software to keep the source code and its development within the platform. Any created software has, by default, a related git repository with wiki pages and issues tracking. These tools are supplied by the integration of Gitlab into the platform. | |
30 | + | |
31 | +The developers can also evaluate the software source code to measuring software quality.. | |
32 | +%TODO: Paulo | |
33 | +%Explain about Mezuro | |
22 | 34 | |
23 | -Expanding the scope of search to cover other kinds of content, the SPB team developed the global search tool. This tool integrates the search mechanisms provided by the collaborative softwares that make up the platform. Any user can find a public content in the context of social network, mailing list and software development. | |
24 | 35 | \ No newline at end of file |
36 | +Thus, the SPB becomes a platform to stimulate the openness of the source code, the dialog between users of the software and its development team as well as the software maintenance and evolution. This, therefore, fosters the transparency in the government investments. | |
25 | 37 | \ No newline at end of file | ... | ... |