• Share
  • Email
  • Embed
  • Like
  • Save
  • Private Content
Web platform.org 기술문서 공유 체계 소개
 

Web platform.org 기술문서 공유 체계 소개

on

  • 323 views

WebPlatform.org 기술문서 공유 체계에 대한 한글 가이드 문서

WebPlatform.org 기술문서 공유 체계에 대한 한글 가이드 문서

Statistics

Views

Total Views
323
Views on SlideShare
323
Embed Views
0

Actions

Likes
0
Downloads
3
Comments
0

0 Embeds 0

No embeds

Accessibility

Categories

Upload Details

Uploaded via as Microsoft PowerPoint

Usage Rights

© All Rights Reserved

Report content

Flagged as inappropriate Flag as inappropriate
Flag as inappropriate

Select your reason for flagging this presentation as inappropriate.

Cancel
  • Full Name Full Name Comment goes here.
    Are you sure you want to
    Your message goes here
    Processing…
Post Comment
Edit your comment

    Web platform.org 기술문서 공유 체계 소개 Web platform.org 기술문서 공유 체계 소개 Presentation Transcript

    • WebPlatform.org  기술문서 공유 체계 소개 2013. 12. 11 박종일 대표
    • 목 차 1 1 WebPlatform.org 공유 체계 분석 2 2 WebPlatform.org 공유 업무 프로세스 3 3 WebPlatform.org 문서 양식 4 4 WebPlatform.org 사이트 구조 5 5 WebPlatform.org / HTML5Rocks.com 비교 6 6 WebPlatform.org 적용 라이선스 7 7 WebPlatform.org 작성시 유의 사항
    • bPlatform.org 공유 체계 분석 커뮤니티 지원 시스템 ● 웹 개발자 문서 ● IRC Chat (irc://chat.freenode.net#webplatform) ● Blog ● Community 특정사업자에 종속되지 않고 더 나은 브라우저나 웹 플랫폼을 지원하기 위한 오픈 커뮤니티 ● Contribute 를 위한 Issue 관리 시스템 제공 웹 관련 기술 콘텐츠 (Topics) ● 초급 개발자 위주의 기술 문서 ● 기술 관련 문법과 예제를 포함 ● 지원 플랫폼 및 디바이스 ● 기술 별 표준화 , 안정성 , 실행 가능 여부 현황
    • latform.org 공유 체계 분석 (2) 가입 커뮤니케이션 - WebPlatform.org 의 목표 및 정책 에 대한 이해 기술 문서 신규 작성 - 신규 기술 문서 작성 - 기존 기술 문서 한글화 ( 참조 링크) 기존 기술 문서 수정 - IRC 가입 (irc.freenode.net#webplatform)  계정 생성 (CC-BY) 라이센스 적용 - 기존 기술 문서의 수정 보완 - 메일링 그룹 가입 (public-webplatform@w3.org) - MediaWiki 문법 사용 ( 페이지 포맷 참고 , MediaWiki - 버그 추적 시스템 가입 문법 참고 ) (http://project.webplatform.org/) - Yahoo Style Guide 준수 - 기존 콘텐츠 검토 (Yahoo Style Guide 참고 ) ●코멘트 작성 ( 의견 교환 ) ●flag 변경 ( 콘텐츠 상태 관리 ) - Code Sample 가이드라인 참조 CC-BY : Creative Commons Attribution 라이센스 ,
    • latform.org 공유 체계 분석 (3) 코멘트를 통한 의견교환 콘텐츠 페이지 상에서 각 제목에 해당 하는 영역에서 코멘트 작성이 가능하며 기존 코멘트가 있는 경 우 기존 코멘트도 확인 가능 클릭하여 코멘 트 보기 클릭하여 코멘트 작성
    • latform.org 공유 체계 분석 (4) 콘텐츠 수정 / 문서 상태 플래그 변경 클릭하여 편집 화면 진입 콘텐츠 수정 편집 항목 - Page title 문서 상태 플래그 종류 - 문서 상태 플래그 - Top-Level Summary - Main Content(MediaWiki 문법으로 작성 ) - Note Section(optional) - Topics ( 문서 구분 ) - External Attribution ( 외부 참조 명시 ) - 수정 내용
    • latform.org 공유 체계 분석 (5) 신규 콘텐츠 작성 신규 콘텐츠 생성 콘텐츠 작성 완료 1. 작업 페이지를 “ Checking 1. 한글화 대상 콘텐츠의 URL WebPlatform.org 에서 콘텐츠 out” 상태로 저장 등록 여부 확인 의 마지막에 “ /ko” 를 붙여서 브라우저에서 로드하여 생성 2. 한글화 콘텐츠 작성 2. New Page 에서 대상 콘텐츠 3. 작업 페이지를 “ Checking 의 url 을 입력하여 생성 in” 상태로 저장 ※ 신규 콘텐츠 작성은 코멘트 작성이나 기존 콘텐츠 수정과 달 리 별도의 Permission 필요
    • latform.org 공유 업무 프로세스 1 2 사전 준비 1-1 콘텐츠 작성 / 등록 2-1 WebPlatform.org 회원가입 한글화 대상 콘텐츠 식별 1-2 3 공유 및 승인 3-1 WebPlatform.org 에 콘텐츠 등록 여부 확 인 2-2 한글화 콘텐츠 생성 후 “ Checking out” 으로 “작업 중” 설정 IRC / Mailing List 가입 기여 절차 2-3 한글 콘텐츠 작성 3-2 한글화 콘텐츠 등록 승인 완료 2-4 완료 후 “ Checking in” 으로 “작업 중” 해제 1-3 산출물 2-5 WebPlatform. WebPlatform. org 계정 org 계정 한글화 콘텐츠 작 한글화 콘텐츠 작 성본 (Web) 성본 (Web) 수정 ( 버전 업) 3-3 게시된 한글화 콘 게시된 한글화 콘 텐츠 (Web) 텐츠 (Web) 사전 준비 콘텐츠 작성 / 등록 공유 및 승인
    • bPlatform.org 문서 양식 (1) 1. Page Title 1) Page Title 기록 2) 문서 상태 Flag 지정 3) 작업 중 (check out) 상태 지정 (※ 복수 지정 가능 ) - High Level Issue : Stub, Deletion Candidate, Merge Candidate, Split Candidate, Move Candidate, Copyright Issue, Unreceptive Title, Needs Flags, Need Topics, Missing Relevant Sections, Data Not Semantic, Unreviewed Import, Needs Review - Content : Outdated, Incomplete, Errors, Not Neutral, Grammar/Spelling, Cleanup, Broken Links, Compatibility Incomplete, Examples Needed, Examples Errors, Examples Best Practices, Accessibility, Needs Summary 4) 편집메모 5) 참고 표준 상태 지정 - 선택항목 : N/A, Mixed, W3C Editor’s Draft, W3C Working Draft, W3C Last Call Working Call, W3C Candidate Recommendation, W3C Recommendation, Deprecated, Non-Standard, De Facto Standard, Experimental. W3C Proposed Recommendation 6) API 이름 2. Top-Level Summary 1) Article Summary 한 단락 이상으로 작성된 문서 요약 . 문서 리스트 상에 노출 되는 내용 . 2) Main Content 문서 본문 ( 미디어위키 문법으로 작성 )
    • bPlatform.org 문서 양식 (2) 3. Examples Section 예제 포함 여부를 지정 4. Example 1) 2) 3) 4) ※ 사용 언어 설정 : HTML, CSS, JAVASCRIPT, Other 예제 설명 요약 (optional) 예제 예제 URL (optional) 여러 개의 예제 삽입 가능 5. Notes Section 1) 사용 방법 (optional) 2) 노트 메모 (optional) 3) 노트 메모 가져오기 (optional) 6. Related Specifications 관련 표준 ( 이름 , URL, 상태 , 관련변화 ) ※ 여러 개의 관련 표준 삽입 가능 7. Compatibility Section 관련 Section 표시 여부 지정 1
    • bPlatform.org 문서 양식 (3) 8. Compatibility Information Imported From Other Pages 관련 Section 표시 응 다른 페이지에서 가져오는 경우 지정 ※ 여러 개의 관련 Section 표시 삽입 가능 9. Compatibility Information(PC):DO NOT EDIT, UNDERGOING AUTOMATION 콘텐츠 페이지를 확인 가능한 Desktop 브라우저 종류 및 버전 명시 (Chrome, Firefox, Internet Explorer, Opera, Safari 별 버전 ) 10. Compatibility Information( 모바일 ):DO NOT EDIT, UNDERGOING AUTOMATION 콘텐츠 페이지를 확인 가능한 Mobile 브라우저 종류 및 버전 명시 (Android, Chrome for mobile, Firefox Mobile, IE Mobile, Opera Mobile, Opera Mini, Safari Mobile 별 버전 ) 11. Compatibility Note 9, 10 에서 표시하지 않은 브라우저 호환성 표시 , 해당 브라우저 이름 , 버전 , 노트 ( 메모 ) 명시 12. See also section 1) WebPlatform.org 내의 관련 Section 지정 2) 관련 Section Manual Link 지정 3) 외부 link 지정 4) 관련 Section 을 노트 형태로 명시 ※ 여러 개의 관련 Section 지정 가능 1
    • bPlatform.org 문서 양식 (4) 13. Topics 1) WebPlatform.org 내의 관련 Topic 지정 ※ 여러 개의 관련 Topic 지정 가능 14. External Attribution 1) CC-BY-SA 라이선스 지정 2) 참고 소스 지정 (MDN, MSDN, HTML5Rocks, Facebook HTML5 Resource Center, DevOpera) 3) MDN Link 입력 (CC-BY-SA 를 체크 하지 않는 경우 optional) 15. Edit Details 수정 내역 요약 작성 ※ 사소한 편집 : 편집내용의 크기에 따라 지정 ※ 이 문서 주시하기 : 문서 변경 이력을 받아볼지 여부 지정 1
    • Platform.org 사이트 구조 (1) 1st Depth 2nd Depth 3rd Depth Main 설명 메인 페이지 DOCS 웹 문서 Beginners Guide 웹 개발 초보자용 가이드 문서 General Web Concepts 웹 작업 , 정보구조 , 타이포그래피 , 웹 디자인의 일반적인 컨셉 / 튜토리얼 문서 HTML HTML 마크업 언어 설명 문서 CSS CSS 설명 문서 Accessibility 다양한 사용자에 대한 접근성 설명 문서 JavaScript 자바스크립트 관련 설명 문서 DOM DOM 설명 문서 SVG SVG 설명 문서 APIs Javascript Web Application API 설명 1
    • Platform.org 사이트 구조 (2) 1st Depth 2nd Depth 3rd Depth EDITING 설명 기여 방법 설명 Register 가입 방법 설명 Communica te 교류 방법 설명 Working the Wiki 콘텐츠 작성 방법 설명 Review existing content 기존 콘텐츠 리뷰 방법 설명 Update existing content 기존 콘텐츠 수정 방법 설명 Add new content 신규 콘텐츠 추가 방법 설명 1
    • Platform.org 사이트 구조 (3) 1st Depth 2nd Depth 3rd Depth 설명 DISCUSSION 논의 방법 설명 BLOG WebPlatform.org 블로그 COMMUNITY WebPlatform.org 커뮤니티 ISSUE 시스템 관리용 이슈 트래커 1
    • g / HTML5Rocks.com 비교 ( 지원 회사 ) Google project 로 개발되어 GitHub 에서 공유되고 있다 . W3C 에 의해 만들어졌으며 위와 같은 stewards 들로부 터 콘텐츠 , 인력 , 자금 , 등의 지원을 받고 있다 . 1
    • .org / HTML5Rocks.com 비교 ( 기능 ) 구분 WebPlatform.org 소스공유 여부 WebPlatform.org 소스는 공유되어 있지 않음 GitHub 를 통해 HTML5Rocks.com 소스 공유 되어 있음 편집 권한 없음 소스 다운로드 가능 콘텐츠 수정 , 코멘트 권한 제공 .  신규 콘텐츠 작성을 위해서는 추가 권한 필요 콘텐츠 수정 / 추가 소스 Pull Request 로 반영 가능 WebPlatform.org 에 계정을 생성하 여 해당 콘텐츠 페이지 상에서 직 접 수정 / 작성한다 . GitHub 를 통해 콘텐츠 페이지를 직접 수정하여 Pull Request 하여 반영한다 . 콘텐츠는 미디어위키 문법으로 작 성한다 . 콘텐츠 작성 시 HTML / CSS/ JavaScript 를 이용하며 Django Framework 에 대한 이해가 필요하 다 계정 미보유 편집 권한 계정 보유 콘텐츠 작성방법 문서 작성시 주의 사항 문서 승인 작성 후 반영 / 별도 승인 절차 없 음 HTML5Rocks.com 승인 절차 있음 1
    • / HTML5Rocks.com 비교 ( 적용 라이선스 ) 1. Creative Commons Attribution 3.0 (CCBY) License : 콘텐츠에 기본적으로 적용되는 라이선스 1. Creative Commons Attribution 3.0 (CC-BY) License : 콘텐츠에 기본적으로 적용되는 라이선스 2. Web Platform Contributor Agreement. ( 참고 ) : 계정 생성시 동의하는 라이선스 2. 구글 CLA(Contributor License Agreements, 개인 / 회사 ) : 시스템을 위한 코드 기여를 하는 기여자에게 만 해당 . 콘텐츠 기여자는 작성하지 않아도 됨. 1
    • mmons Attribution 3.0 (CC-BY) License 1. 이용자 권리 - 공유 및 이용 (Share) : 저작물의 복제 , 배포 , 전시 , 공연 및 공중송신 - 재창작 (Remix) : 저작물의 개작 , 수정 , 이차저작물 작성 (※ 이 저작물을 영리 목적으로 이용할 수 있음 ) 2. 사용 조건 - 저작자표시 : 저작자가 이용허락자가 정한 방법으로 저작물의 원저작자를 표시하여야 합니다 . ( 그러나 원저작자가 이용자나 이용자의 이용을 보증하거나 추천한다는 의미로 표시해서는 안됩니다 .) 3. 숙지 사항 - 권리포기 : 저작권자로부터 별도의 허가를 받으면 이러한 조건들에 대한 권리도 포기될 수 있습니다 . (※CC 라이선스에서는 이용허락자가 예를 들어 저작자표시와 같이 특정 조건에 대해서는 권리를 포기하고자 하 는 경우도 있음을 인정합니다 .) 4. 주의 사항 - 재사용 또는 배포하는 경우 , 타인에게 해당 저작물의 라이선스 조건을 명시해야 합니다 . 5. 추가 참조 (※ 참조 : http://creativecommons.org/licenses/by/3.0/deed.ko) 1
    • Platform.org 작성시 유의 사항 WebPlatform.org 한글 콘텐츠 기여 Contributors ※ HTML5 기술문서 작성시 유의 사항 • WebPlatform.org - WebPlatform.org 의 Editor 를 위해서는 편집자 가이드 및 IRC 를 통한 커뮤니케이션 필요 - Contributor 의 개별적 활동은 확인할 수 있으나 작업 진행 중복에 대해 제어할 방법 없음 2