ubunchuu-truong-us / ubunchuu-truong-us.github.io

▶️ Open-source ubunchuu-truong-us linux documentation. Built with 💚 and built for easy contribution 👨🏻‍💻.
https://ubunchuu.com
MIT License
11 stars 1 forks source link

Implement Cross-Platform Content Automation Pipeline #70

Open lelouvincx opened 1 month ago

lelouvincx commented 1 month ago

Context: The project needs an automated workflow to streamline content distribution across multiple platforms when new content is merged into the main branch. This will ensure consistent and timely content delivery to our audience.

As a content creator on the Ubunchuu Trường Ú project,
I want an automated system that deploys new content to our website and cross-posts to Facebook and viblo.asia when content is merged to main,
so that we can maintain consistency across platforms and reduce manual publishing effort while reaching our audience more effectively.

Acceptance Criteria:

  1. GitHub Actions workflow triggers automatically when content is merged to main branch
  2. New content is successfully deployed to the project website
  3. A new post is created on Facebook with:
    • Post title
    • Brief description
    • Link to the full article on our website
  4. Content is published on Viblo.asia with:
    • Full article content
    • Proper formatting and syntax highlighting
    • Links back to our project website
  5. Error notifications are sent to the team if any part of the automation fails
  6. Deployment status is visible in GitHub

Definition of Done:

  1. Code Implementation:

    • GitHub Actions workflow is properly configured
    • Facebook API integration is implemented and tested
    • Viblo.asia API integration is implemented and tested
    • Error handling and logging mechanisms are in place
  2. Testing:

    • Unit tests for each integration component
    • End-to-end testing of the complete workflow
    • Test deployments performed in staging environment
    • Manual verification of posts on all platforms
  3. Documentation:

    • Technical documentation for the automation workflow
    • Setup guide for API credentials and tokens
    • Troubleshooting guide for common issues
    • Update to project README.md
  4. Approval & Review:

    • Code review by at least one team member
    • Final approval from requester (@lelouvincx)
    • Security review of API implementations
    • Successful demonstration to team members
thangbuiq commented 1 month ago

Hi @lelouvincx, we should list down the platform that need to upload posts, this platform should be:

lelouvincx commented 1 month ago

Hi @lelouvincx, we should list down the platform that need to upload posts, this platform should be:

  • have API/SDK to allow user upload, should be free / no pricing plan for developers
  • well documentation for guiding user how to upload post (viblo is not)

Firstly, Facebook.

Seems like viblo.asia is not well-documented, I wonder can we use their API platform to automatically publish new posts as markdown format. Copy @greyyT , pls help me figure out this.

Consider choices: