[Scheduled] Automate "Last Updated" Field in metadata table

[mukmookk]

In order to maintain the most recent update information for our .md files, we are considering automating the update of the "Last Updated" field using GitHub Actions.

Works expected:

1. Create a GitHub Action workflow for the repository.
2. Within the workflow, scan for changed .md files in the commit.
3. For each changed .md file, modify the "Last Updated" field to reflect the current date.
4. Commit the updated .md files with a message like "Automatically updated Last Updated field".

[jeesang7]

좋은 아이디어 입니다
해당 작업이 devops, CI/CD 이런 기술들을 공부하는데 좋은 기회가 될 것 같습니다.
특히, devops 쪽에 관심있는 분들은 이모티콘으로 반응 주시면 같이 협업할 기회를 마련하도록 하겠습니다

[mukmookk]

기능을 굳이 도입해야할지에 대해서 고민이 있습니다.

현재 두 가지 방식으로 수행을 할 수 있을 것으로 예상이 되는 상황입니다.

1. pre-commit의 훅을 활용

Pros

• 별도의 커밋 없이도, 기여자가 md 파일을 커밋하면 자동으로 커밋 전에 pre-commit 훅에 등록된 내용이 반영됩니다. -> 커밋 로그가 깔끔해집니다.

Cons

• pre-commit이라는 별도의 파이썬 패키지를 설치 후, 해당 훅을 등록해야 합니다. pip install pre-commit -> 문서 번역 기여 시의 장벽으로 동작할 우려가 있습니다.

단점이 다소 치명적이기에 CI 방식으로 고려를 했습니다만 마찬가지로 우려 사항이 존재합니다.

2. Github Action을 통한 CI

Pros

• 사용자가 굳이 관리하지 않아도 깃허브에서 알아서 날짜를 변경해줍니다.

Cons

• Github Action에서 스크립트를 실행하여, 날짜를 업데이트해도 결국 CI 파이프라인에서 commit, push를 해야합니다.
• 때문에 md 파일을 커밋할 시, 반드시 Github Action에서 수행하는 별도의 commit이 붙게 됩니다. -> 커밋 내역이 매우 지저분해질 우려가 있습니다.

때문에 굳이 꼭 도입을 해야할까라는 고민이 드는 상황입니다.

[yeongseon]

메타데이터 테이블 구현 완료

✅ 구현 내용

파일 생성:

• _includes/metadata_table.html - 재사용 가능한 include 컴포넌트

사용 방법:

{% include metadata_table.html 
   original_title="Original Document Title" 
   original_link="https://azure.github.io/azure-sdk/original_page.html"
   last_updated="2023-10-15" 
%}

예시 구현:

• docs/policies/releases.md - 메타데이터 테이블 적용 완료

문서화:

• CONTRIBUTING.md - 메타데이터 테이블 사용 가이드 추가

🎯 적용 원칙 (Oracle 권고사항 반영)

• ✅ Opt-in 전략: 새 번역 작업 시 추가 권장
• ✅ 범위 제한: 기존 문서 일괄 변경 금지 ([Scheduled] Add Metadata Table to the Top of Markdown Files #179 scope creep 방지)
• ✅ 단순 구현: Jekyll 플러그인 불필요, include 기반
• ✅ 빌드 검증: Jekyll 빌드 성공 (3.192초)

📋 다음 단계

이 이슈는 메타데이터 인프라 구축으로 완료되었습니다.
#179 (일괄 적용)는 별도 검토가 필요하며, Oracle 권고사항에 따라 전체 리포지토리 포맷 변경을 피하도록 합니다.

권장 적용 시나리오:

1. 새 문서 번역 시 자동 포함
2. 업스트림 동기화 작업([Scheduled] docs outdated: General Guidelines > Implementation > 'Parameter validation' #169, [Scheduled] docs outdated: General Guidelines > Implementation > 'Distributed Tracing' #170, [Scheduled] docs outdated: General Guidelines > Implementation > 'Dependencies' #171) 시 선택적 추가
3. 사용자 요청 시 개별 문서 추가